There used to be a website (an old one, from when Haxe spelled "haXe") that got you started.
But that is no more. I decided to get some of that back. Based upon the information from the old site and my own need to document this.
Read more about that here. But it boils down to: JUST DO IT!
Visit https://github.com/MatthijsKamstra/haxejs to modify the "source" aka markdown files.
Found any "bug" or have a great idea? Please create a new issue.
I will be using Gitbook to export to static html.
You need to install Node.js and then you automatically have NPM:
Install gitbook
npm install gitbook-cli -gor if you have gitbook installed, update it
gitbook updateI wanted to make the editing of these file as-easy-as-possible. This gitbook plugin helps with that: gitbook plugin edit link. And if all fails, I used Disqus comments on your books to add comments at the bottom of each page.
Activate the plugins with:
gitbook installExport everything to html
gitbook buildI created a little script with NPM to make my life somewhat easier:
npm run gitbookWill install and update gitbook
npm run buildWill remove old docs- and _book-folder, build new gitbook and rename _book- to docs-folder.
npm run deployWill just push everything without consideration
I will be using gitbook to generate the website.
Primarily reason for this: I have never used it, it uses markdown as input files and it also generates a static html site.
A familiar way to write documentation for developers.
This should make it easier to contribute!
Markdown is a plain text formatting syntax created by John Gruber, aiming to provide a easy-to-read and feasible markup. You can find the original Markdown syntax specification here.
MacDown is a simple-to-use editor for Markdown documents. It renders your Markdown contents real-time into HTML, and display them in a preview panel. You can download it here.
You can find the original data with WayBack Machine