The latest version of the recipe book can be found here: https://suse.github.io/recipebook/recipes.html
-
Clone the repo and open recipes.adoc locally in a browser that supports AsciiDoc or in another tool such as asciidoctor
-
The GitHub preview of the in-development recipes is at recipes.adoc.
Want to help? We love to hear that! Below are a few hints to guide you.
-
Create a new recipe file under recipes/<appropriate_directory>/ Consider copying the recipe_template.adoc from the top level folder to have a baseline to work from.
-
Make sure you include a section identifier
[id='sec.recipe_name']and a title=== Recipe Nameeach on their own line and separated by an empty line from other content -
Add a reference to the new recipe to recipes.adoc in the top level
-
Add any images to images/<recipe_name>/
-
build the docs with docbuild.sh (requires asciidoctor, see below for install details)
-
check the output at build/recipes.html to verify it matches the formatting you want
It is recommended to start your recipe by copying recipe_template.adoc from the top level folder. Alternately, look at the existing recipes to copy the formatting for setting the images folder, which is a little awkward as we want it to render correctly with github’s preview.
These release notes are written in the AsciiDoc (*.adoc) format. For some
great AsciiDoc documentation, see https://asciidoctor.org/docs/asciidoc-writers-guide/.
Viewing asciidoc is most easily done via a plugin to Chrome such as https://chrome.google.com/webstore/detail/asciidoctorjs-live-previe/iaalpfgpbocpdfblpnhhgllgbdbchmia
Add your recipe under recipes/<recipe-type> … desserts go under recipes/desserts for example
Images associated with the recipe should be added under the images folder at the top level, then inside a sub-folder with the recipe name
Asciidoctor can be installed for Leap 15.2 at https://software.opensuse.org/package/rubygem-asciidoctor Other distributions can be found at https://asciidoctor.org/#a-linux-package-managers. You can also install it using bundler or via gem directly:
bundle install
# or
gem install asciidoctorAfter installing asciidoctor, run the build:
./docbuild.sh
# or if you installed asciidoctor via bundler
bundle exec -- ./docbuild.shThe output of the build will be build/recipes.html
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent