Go to file
Vincent Prouillet 9e62651777
Merge pull request #328 from codesections/master
Edit docs to clarify RSS process
2018-07-09 12:43:23 +02:00
ci Improve sorting speed 2017-07-04 18:33:58 +09:00
completions Fix config CLI option 2018-03-16 19:11:12 +01:00
components Update more deps and appveyor config 2018-06-22 13:39:29 +02:00
docs Edit docs to clarify RSS process 2018-07-08 11:21:24 -04:00
src Write some docs 2018-03-21 16:18:24 +01:00
sublime_syntaxes cargo update for new version 2018-06-22 13:34:47 +02:00
sublime_themes Add a bunch of themes, light and dark. 2018-02-28 21:15:25 +00:00
test_site Fix internal links to content dir not working 2018-03-29 14:55:26 +02:00
.editorconfig Create new project 2016-12-06 14:51:33 +09:00
.gitignore Add snacraft config 2018-06-04 23:37:55 +12:00
.gitmodules Add CMake syntax and update other syntaxes 2018-04-13 15:07:30 +02:00
.travis.yml Try to remove sudo: required in travis 2018-01-25 12:44:41 +01:00
appveyor.yml Appveyor config fix 2018-06-22 14:29:11 +02:00
build.rs Config with i18n 2018-01-15 17:54:06 +01:00
Cargo.lock v0.3.4 2018-06-22 15:14:12 +02:00
Cargo.toml v0.3.4 2018-06-22 15:14:12 +02:00
CHANGELOG.md cargo update for new version 2018-06-22 13:34:47 +02:00
EXAMPLES.md Add Tinkering to EXAMPLES.md 2018-04-02 11:15:30 -04:00
LICENSE USe date range for license 2018-01-16 13:39:56 +01:00
netlify.toml Update gutenberg version on netlify 2018-03-29 20:21:35 +02:00
README.md Update README.md 2018-04-10 08:06:49 +02:00
snapcraft.yaml Move snapcraft file 2018-06-22 13:40:26 +02:00

Gutenberg

Build Status Build status

A fast static site generator in a single binary with everything built-in.

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

Comparisons with other static site generators

Gutenberg Cobalt Hugo Pelican
Single binary
Language Rust Rust Go Python
Syntax highlighting
Sass compilation
Assets co-location
i18n
Image processing
Sane template engine ✕✕✕
Themes
Shortcodes
Internal links
Table of contents
Automatic header anchors
Aliases
Pagination
Custom taxonomies
Search
Data files

Supported content formats:

  • Gutenberg: markdown
  • Cobalt: markdown
  • Hugo: markdown, asciidoc, org-mode
  • Pelican: reStructuredText, markdown, asciidoc, org-mode, whatever-you-want

Note that many features of Pelican are coming from plugins, which might be tricky to use because of version mismatch or lacking documentation.

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/SublimeElmLanguageSupport

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.