https://github.com/sovereigncloudstack/newsletter
Newsletter for the SCS community
https://github.com/sovereigncloudstack/newsletter
community
Last synced: 12 months ago
JSON representation
Newsletter for the SCS community
- Host: GitHub
- URL: https://github.com/sovereigncloudstack/newsletter
- Owner: SovereignCloudStack
- License: mit
- Created: 2022-01-27T08:34:40.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-24T08:40:51.000Z (about 1 year ago)
- Last Synced: 2025-01-13T08:12:41.423Z (about 1 year ago)
- Topics: community
- Language: Ruby
- Homepage: https://sovereigncloudstack.github.io/newsletter/digest/
- Size: 54.1 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Newsletter for the SCS community
This repository contains a [Jekyll](https://jekyllrb.com/)-powered blog for the SCS community digest newsletter.
The generated static site is automatically deployed to GitHub pages on every push: https://sovereigncloudstack.github.io/newsletter/digest/4/
## How do I create a new issue?
Simply create a new `yml`-File under `/digest/` and follow the template of the existing issues.
The recent issue can then be found at `https://sovereigncloudstack.github.io/newsletter/digest/{issue}`
- The repository must be checked out
- A new branch has to be created (VS Code > Source Control > Branch > Create Branch)
- In the folder _digest there are numbered Markdown files which stand for the respective digest.
- For a new digest, create a new .md file in the _digest folder with the new number. (Tip: It is best to copy the previous one and change the name. This way you have taken over the layout/structure directly and can change text and links to images).
- In the assets folder there are numbered folders which stand for the respective digest. In this folder are all images for the respective digest.
- All changes have to be checked in (VS Code > Source Control > Commit & Push).
- GitHub Homepage > Pull Requests > New Pull Request
- select previously created branch in "compare:xyz
- Review changes again, then Create Pull Request
- Add comment if necessary
- Create Pull Request
- Resolve conflicts if necessary
- Check the "Merge without waiting..." checkbox
- Squash and merge > Confirm squash and merge
- Once the PR is merged, start a gh-action and build an .eml (email) and .html (good for a preview if everything fits) to this address: https://sovereigncloudstack.github.io/newsletter/digest/${number} Replace the variable ${number} with the corresponding digest number.
## How can I send out the mailing?
The generated `eml`-File can be found at `https://sovereigncloudstack.github.io/newsletter/digest/{issue}/mailing.eml`.
For sending out the mailing to the mailing list, you can use [swaks](http://www.jetmore.org/john/code/swaks/) for instance.
Create a configuration file `.swaksrc` in your home directory and add the following content:
```
--from john.doe@acme.org
-tls
--server smtp.acme.org
--port 587
--auth-user john.doe
--h-Message-ID %MESSAGEID%
```
Use `swaks -d mailing.eml` to send out the downloaded newsletter to a given address.
If you then download the .eml from https://sovereigncloudstack.github.io/newsletter/digest/${number}/mailing.eml you can send it. How to send a mail is described here: https://sovereigncloudstack.github.io/newsletter/digest/
GitHub - SovereignCloudStack/newsletter: Newsletter for the SCS community - GitHub
Newsletter for the SCS community. Contribute to SovereignCloudStack/newsletter development by creating an account on GitHub.
scs-member@lists.scs.community