No description
Find a file
Baptiste Darthenay 046de8c998 Config with i18n
2018-01-15 17:54:06 +01:00
ci Improve sorting speed 2017-07-04 18:33:58 +09:00
completions Add output-dir option to build & serve 2017-12-29 19:26:17 +01:00
components Config with i18n 2018-01-15 17:54:06 +01:00
docs Mention lack of quotes for dates in docs 2018-01-14 18:08:04 +01:00
src Reload on config change (#206) 2018-01-12 11:50:29 +01:00
sublime_syntaxes Update syntaxes 2018-01-02 18:14:26 +01:00
sublime_themes Add 1337 color scheme 2017-10-03 23:23:58 +09:00
.editorconfig Create new project 2016-12-06 14:51:33 +09:00
.gitignore WIP site 2017-09-08 18:59:51 +09:00
.gitmodules Update syntaxes 2018-01-02 18:14:26 +01:00
.travis.yml Add earliest Rust version to travis 2017-11-26 10:07:34 +01:00
appveyor.yml Sass works on windows; try to use msvc on appveyor 2017-07-13 22:45:31 +09:00
build.rs Config with i18n 2018-01-15 17:54:06 +01:00
Cargo.lock Use TOML dates in front-matter rather than strings 2018-01-14 18:04:01 +01:00
Cargo.toml Cargo update 2017-12-29 19:51:22 +01:00
CHANGELOG.md Use TOML dates in front-matter rather than strings 2018-01-14 18:04:01 +01:00
LICENSE Forgot License 2017-03-30 15:35:04 +09:00
netlify.toml Finishing up site (#131) 2017-10-19 13:48:50 +02:00
README.md Added j1m.net as a site which uses Gutenberg 2017-11-22 12:20:00 -06:00

Gutenberg

Build Status Build status

An opinionated static site generator written in Rust.

Documentation is available on its site or in the docs/content folder of the repository.

Example sites

Contributing

As the documentation site is automatically built on commits to master, all development should happen on the next branch, unless it is fixing the current documentation.

If you want a feature added or modified, please open an issue to discuss it before doing a PR.

Adding syntax highlighting languages and themes

Adding a syntax

Syntax highlighting depends on submodules so ensure you load them first:

$ git submodule update --init 

Gutenberg only works with syntaxes in the .sublime-syntax format. If your syntax is in .tmLanguage format, open it in Sublime Text and convert it to sublime-syntax by clicking on Tools > Developer > New Syntax from ... and put it at the root of sublime_syntaxes.

You can also add a submodule to the repository of the wanted syntax:

$ cd sublime_syntaxes
$ git submodule add https://github.com/elm-community/Elm.tmLanguage.git

Note that you can also only copy manually the updated syntax definition file but this means Gutenberg won't be able to automatically update it.

You can check for any updates to the current packages by running:

$ git submodule update --remote --merge

And finally from the root of the components/rendering crate run the following command:

$ cargo run --example generate_sublime synpack ../../sublime_syntaxes ../../sublime_syntaxes/newlines.packdump ../../sublime_syntaxes/nonewlines.packdump

Adding a theme

A gallery containing lots of themes is located at https://tmtheme-editor.herokuapp.com/#!/editor/theme/Agola%20Dark. More themes can be easily added to gutenberg, just make a PR with the wanted theme added in the sublime_themes directory and run the following command from the root of the components/rendering:

$ cargo run --example generate_sublime themepack ../../sublime_themes ../../sublime_themes/all.themedump

You should see the list of themes being added.