Markdown compiler for github pages
This package is auto-updated.
Last update: 2020-01-19 10:47:31 UTC
gh-pages-compiler generates a website from your markdown documentation.
This package is not maintained anymore. A more recent and complete version is here: Couscous.
Github pages are good, but what do you do:
- if you want to write your documentation in Markdown and not in HTML?
- if you want your documentation to be transformed into a website?
- if you want to keep the documentation with your code, versioned in the repository?
gh-pages-compiler is here to help you. Your documentation is written in Markdown, versioned in your repository with your source, compiled to HTML and published to Github pages.
- you write your README and documentation in
.mdfiles (Markdown) on your repository
- you generate you website with gh-pages-compiler
- it turns
.mdfiles into HTML files
- HTML files are committed to the
gh-pagesbranch of your repository, and thus are published as a website by Github
- compiles Markdown using the same configuration as Github (to ensure correct results)
- full control over the website layout: you write your own template and menus
- hosted by GitHub on "Github pages", you don't have to host your website
- your README will be your home page, your code repository will always be in sync with your website
Follow the project on Github
Created by Matthieu Napoli, using and inspired by: