openSUSE News Website, providing news to the community.
-
Create a new markdown file in
_posts
directory. File name should followyyyy-mm-dd-title.md
format. For example,2020-02-27-my-first-post.md
. You can start by clicking this link. -
Please use an illustration image with at least 1153x505px size. It should be placed as well in its own directory named with the date format
yyyy-mm-dd
in/assets/images
. For example:/assets/images/2020-02-27/my-first-post-image.png
. If you need help with creating some approriate image feel free to ask in #artwork on IRC, Matrix or Discord. -
Write content. You can start with the following template:
--- author: Stasiek Michalski date: 2020-02-27 19:27:17+00:00 layout: post license: CC-BY-SA-3.0 title: My First Post image: /assets/images/omw.png categories: - Announcements tags: - infrastructure - websites --- Write you post in Markdown and HTML...
The date and time you set here, in the header, will be the date and time your article, once merged, will be published and available on news.opensuse.org. If you set the current day's date, be aware that there might be up to 2 hours delay between the time the PR got accepted and the time it actually gets picked up by the server.
-
Save the file and create a pull request. You can find the button at page bottom.
In order to run bundle
the two following addional packages are needed: 'rubygem(bundler)' ruby-devel
.
bundle install --path vendor/bundle
bundle exec jekyll build
Resulting site will be in _site
directory.
bundle install --path vendor/bundle
bundle exec jekyll serve
Visit http://127.0.0.1:4000/ in your browser.
If there's a newer revison of the openSUSE jekyll-theme you need to put the commit id into Gemfile.lock and count up the version number.