=====================
This repository holds the bndtools.org website hosted at https://bndtools.org. This web site is maintained as markdown and turned into HTML by Jekyll using GitHub Pages.
- install ruby 2.7
- call
./run.shon the commandline
This should install jekyll and start a local webserver at:
Start editing markdown .md files. Jekyll will auto-detect changes and reload the website. Some changes require a restart (e.g. changes to _config.yml)
- jekyll uses
rougecode highlighter - see
_config.ymland sectionsyntax_highlighter_opts - also see this website https://jekyll-themes.com/brazacz/rouge-themes for examples
- rouge is compatible with and can use 'pygments' styles (see https://pygments.org/styles/)
- these styles can be generated with the command
The following commands locally will help to generate the .css files for the pygment styles:
gem install rouge
# show a list of supported styles
rougify help style
# go to the css folder
cd css
# generate the css
rougify style monokai > monokai.css
Then reference the .css file in _includes/head.html
Feedback is always welcome. For general discussions use the bndtools-users@googlegroups.com list. We also have the bndtools-dev@googlegroups.com list for discussions on the development of bndtools.
Bugs and issues for the https://bndtools.org website should go to https://github.com/bndtools/bndtools.github.io/issues
Want to hack on the bndtools.org website? See CONTRIBUTING.md for information on building, testing and contributing changes.
They are probably not perfect, please let us know if anything feels wrong or incomplete.
The contents of this repository are made available to the public under the terms of the Eclipse Public License v1.0.