Convert project web site to Jekyll about teals-minecraft

[hawkerm]

Feel free to check out my config file I use for Space Battle here: https://github.com/Mikeware/SpaceBattleArena/blob/master/_config.yml

I set it up, so I can use the gh-pages repository to host on GitHub and have it read from the doc folder of my main project's markup.

[hollasch]

@hawkerm It doesn't look like you're using Jekyll any more. Am I correct in thinking it's just HTML now?

[hawkerm]

@hollasch curious, what makes you say that? Jekyll compiles down to HTML in the end, so to the browser it's just a collection of HTML pages. But in the back-end of my doc repro it's all markdown.

I need to resetup my tool chain on my new machine now though...

[hollasch]

Interesting, looks like you have a non-standard setup, where your doc sources are in master in the docs/ directory, and your gh-pages branch contains the generated HTML output. The standard GitHub Jekyll setup is to put Jekyll configuration and source *.md files in the gh-pages branch (or now, the docs directory), and GitHub auto-generates the resulting HTML site on the fly, served to the project web site.

That said, getting Jekyll and its requirements to run in a PC environment was painful enough that I wrapped up my experiment after a day of fiddling, as it would require a fussy setup for every other author who wanted to view results locally as they develop new materials.

[hollasch]

I'm going to table this for now.

[hawkerm]

@hollasch good to know about the GitHub auto-generate. I was setting it up in my master so I could move docs alongside the code as I made changes, generate locally to ensure docs looked good, and then push to the docs branch the changes that snapped to the code when I made a new release.