/jbossorg.github.io

Blog site for jboss.org

Primary LanguageTypeScript

JBoss.org Site

Two Ways To Add A Post

  1. Use the Github.com interface
    1. Go to https://github.com/jbossorg/jbossorg.github.io/tree/src/src/content/posts
    2. Add file >> "Create new file" OR "Upload files"
    3. File name should be in the format weekly-yyyy-mm-dd.adoc
  2. Use the src git branch
    1. Run git clone --single-branch --branch src https://github.com/jbossorg/jbossorg.github.io.git jbossorg
    2. Add a file named in the format of weekly-yyyy-mm-dd.adoc to jbossorg/src/content/posts

New Post Content and Publishing

  1. Front Matter (first four lines of the post file) should be:
    1. = JBoss Weekly Editorial 14 May 2020 (or a relatively unique title that isn't just "JBoss Weekly Editorial")
    2. Firstname Surname
    3. YYYY-MM-DD
    4. :tags: any, tags, you-want, comma-separated
  2. Commit and Push the changes or create a Pull Request to the src branch

Community Blogs Aggregation

The website aggregates community blogs and index 20 most recent posts.

To add a new blog you need to:

  1. Add your blog's RSS/ATOM url into aggregator-feeds.yaml.
  2. Create a pull request to the src branch.

Notes

  • A Pull Request to the src branch will publish to the staging site
  • If you want to embed any images into the site, place them in src/img/
  • Profile images for authors are found under src/img/people if you don't like the default just update yours