Unofficial tutorials for openstreetmap-carto.
┌┬┐┌─┐┌─┐ ┬┌─┐┬┌─┬ ┬┬ ┬
│││ ││ ── │├┤ ├┴┐└┬┘│ │
─┴┘└─┘└─┘ └┘└─┘┴ ┴ ┴ ┴─┘┴─┘
This Jekyll-based theme named DOC-JEKYLL is specifically intended for static technical documentation deployable on GitHub Pages.
Information on the usage of this theme can be found in how to contribute.
- Lanyon theme, by Mark Otto. Many modifications have been added on top.
- Bootstrap 3.3.7
- jQuery 2.1.4
- GitHub buttons by mdo
- AnchorJS plugin, (c) 2016 Bryan Braun; licensed MIT
- Table of Contents plugin for Bootstrap (ScrollSpy plugin), (c) 2015 Aidan Feldman, licensed MIT (https://github.com/afeld/bootstrap-toc/blob/gh-pages/LICENSE.md), with some improvements to support all headers from h1 to h6
- github.commits.widget, (c) 2012 Alexander Beletsky, with some improvements
- lanyon-plus
- clipboard.js by Zeno Rocha
- A Jekyll layout that compresses HTML in pure Liquid, © 2014–2015 Anatol Broder. Released under the MIT License. The compressor has been modified in order to also obtain a very basic Liquid Javascript compressor.
- Fonts and icons from http://fontawesome.io/, designed by Freepik and distributed by Flaticon (http://www.flaticon.com/authors/freepik), https://openclipart.org/ and https://icomoon.io
- matteobrusa's code to show a styled markdown document from an URL
- roperzh's code to parse and view man pages
Licensed under the MIT License
Hosted by GitHub
This site can be cloned and reused freely. The following files and data are specific and need deletion or customization when forking this site for different purposes:
- _config.yml, including all project specific parameters (shall be customized)
- README.MD (shall be customized)
- public/favicon.ico and public/apple-touch-icon-precomposed.png (shall be customized)
- All files in "pages", "_notes" and "_posts" directory (shall be removed)
- googlec45135b10de87878.html (shall be removed)
- the pages subdirectory inside _includes
Summary of the main changes from the default Lanyon Theme:
- additional settings in _config.yml
- developed improved sidebar
- added last modification date for the whole site and for each page (using GitHub commit dates)
- added last site version (using last GitHub tag name)
- revised css and js to allow fully responsive site for smartphones, tablets and different desktop resolutions
- developed extensive style for print including automatic chapter numbering
- developed a smart site map
- improved Atom RSS
- added integration with Disqus, Google Search Custom, Google Analytics
- Home page revised
- improved lanyon.css and poole.css
- Developed an extension of the Lanyon stylesheet which supports drawings.
- Usage of compressed scss styles. Single style.css style compiled and compressed afer merging all scss/css styles
- Integrated a Liquid HTML compressor
- Added a very basic Liquid Javascript compressor
- Added footnotes management