This GitHub project, available from gnu-mcu-eclipse/gnu-mcu-eclipse.github.io-source, contains the source files used to generate the GNU MCU Eclipse Web Site.

The GNU MCU Eclipse Web Site is an organisation GitHub Pages site, stored in the gnu-mcu-eclipse/gnu-mcu-eclipse.github.io Git and publicly available from http://gnu-mcu-eclipse.github.io.

The web site is generated off-line by Jekyll. It cannot be generated by GitHub Pages because it uses Jekyll plug-ins, considered unsafe and disabled by the GitHub Pages instance of Jekyll.

To be able to run the Jekyll build process, the ruby interpreter and the gem tool are required. In macOS 10.10.5, these tools are preinstalled, at least when the Developer Command Line tools are present.

$ ruby --version
ruby 2.0.0p481 (2014-05-08 revision 45883) [universal.x86_64-darwin14]
$ gem --version
2.0.14
$ sudo gem install jekyll
...
$ jekyll --version
jekyll 2.5.3

In addition, the several specific gems are required:

$ sudo gem install redcarpet jekyll-mentions jemoji jekyll-redirect-from jekyll-feed jekyll-sitemap jekyll-last-modified-at

To update the bundled gems:

$ bundle install

To manage the web site, a local copy of this repository is required.

$ git clone https://github.com/gnu-mcu-eclipse/gnu-mcu-eclipse.github.io-source.git gnu-mcu-eclipse.github.io-source.git

The current development cycle is edit-save-build-view.

The build can be performed automatically by Jekyll when started in server mode.

$ cd gnu-mcu-eclipse.github.io-source.git
$ jekyll serve --baseurl "" --trace

To view the result, point the browser to localhost:4000.

Normally the Travis job published the site if everything is fine.

When running the build manually, the result is in the _site folder.

This folder is configured as a submodule, linked to the gnu-mcu-eclipse.github.io project.

To publish, commit this Git and the new site will be automatically updated.

All blog posts are in the _posts folder, with specific pages in qemu, openocd and windows-build-tools.

Drafts are posts you’re still working on and don’t want to publish yet. They are stored in the _drafts folder and later moved to _posts when ready.

To preview your site with drafts, simply run jekyll with the --drafts switch.

All web pages are in the pages folder, with specific pages in qemu, openocd and windows-build-tools.

To maintain sitelink.xml usefulness, while maintaining pages and posts, it is necessary to keep this variable up-to-date.

As per _config.yml, the default timezone is UTC. For other timezones, set it explicitly as offset (for example +0300)

Contributions are welcomed!

Please review the Contributing Guidelines for details.