OK, a standard dialect of Markdown. In the beginning was RUNOFF from MIT, which originally had about the power of Markdown. More features were added, and it became nroff, then troff, the ditrofff, and macro systems were added on top of it. It became too hard to use for casual work. Then there was TeX, which was a saner approach to what troff did. Macro systems were added on top of it. It became too hard to use for ca…
That's why I prefer ReST. More powerful syntax out of the box with a standard extension scheme so you don't end up with the mess of all the different incompatible Markdown implementations. With the internal structure exposed as an XML format (rst2xml) it is easy to transform documentation into a wide variety of formats that docutils or Sphinx don't handle directly.
GitHub pages is now running Jekyll 3
71–80 of 119 posts
Re: GitHub pages is now running Jekyll 3
#72Re: GitHub pages is now running Jekyll 3
#73OK, a standard dialect of Markdown. In the beginning was RUNOFF from MIT, which originally had about the power of Markdown. More features were added, and it became nroff, then troff, the ditrofff, and macro systems were added on top of it. It became too hard to use for casual work. Then there was TeX, which was a saner approach to what troff did. Macro systems were added on top of it. It became too hard to use for ca…
The nice thing about Markdown that doesn't apply to those other formats is that it's designed to read naturally in plaintext. That constraint should (in theory) prevent it from transforming into something prohibitively complicated to write in.
Also, the silly space-at-the-end for line breaks.
Re: GitHub pages is now running Jekyll 3
#74It's a static site generator with a slick React powered admin interface intended for editors (non-programmers) to use. It runs locally like any good static site generator should and runs on Windows, OSX and Linux. With the click of a save button, it'll upload your statically generated site to any ftp or rsync server you choose ;)
Took me only 2 hours to have it building a page with a nav menu, localization, and a slick admin interface even though I had never even used Python before!!
All you do is declare your models, place references to them in your templates, and it handles the rest for you automatically.
The project is still a little rough around the edges as it was only released in December, but I'm already falling in love with it and I'm really excited to see how it changes the web once it gets built out a bit more.
Non-programmer editable static sites is a huge deal!!!!
Re: GitHub pages is now running Jekyll 3
#75Absolutely love Jekyll and GitHub Pages for hosting project documentation and personal websites. Just wish GH Pages would support SSL. :(
You can even get a custom domain with SSL (via LetsEncrypt) going for it.
Here's what you need to do:
* Set a CNAME record for your Github Page: https://help.github.com/articles/setting-up-a-custom-domain-...
* Add custom domain to Kloudsec
* Update custom domain to Kloudsec's Anycast CDN IP
* Enable "One-click Encryption" plugin to automatically provision a LE cert.
* If you want to automatically redirect all HTTP -> HTTPS: https://kloudsec.freshdesk.com/support/solutions/articles/90...
Hope this helps :)
Re: GitHub pages is now running Jekyll 3
#76Absolutely love Jekyll and GitHub Pages for hosting project documentation and personal websites. Just wish GH Pages would support SSL. :(
I'm working on a static hosting service. We are working on SSL and making that easy. Would you be interested in trying the beta? http://www.statichosting.co
The cost is a non-starter. The main reason I go through the hassle of writing compilers for my websites is that I want them to be long-lived.
Presently, I use Nearly Free Speech as my hosting provider. Their pricing scheme for static sites costs me about $2.50/yr and I can maintain an account balance. My $50 account balance will keep my site online for two decades whereas it would buy me only ten months on your service. (Not to mention that Github hosts static sites for free!)
To consider another service, it wouldn't just have to beat the cost but instill a sense of confidence that I could trust the service with my data for the foreseeable future. A few features could tip the scales though: - Open ID auth instead of basic access auth - Easy SSL setup (gethttpsforfree.com was recently a huge help) - Inexpensive hosting for a very low-volume mailing list with HTML archives
Good luck!
Re: GitHub pages is now running Jekyll 3
#77I just found out about Lektor the other day. https://www.getlektor.com/ It's like Jekyll meets WordPress, written in Python by Armin Ronacher. He's the guy who wrote the extremely popular Python microframework, Flask. It's a static site generator with a slick React powered admin interface intended for editors (non-programmers) to use. It runs locally like any good static site generator should and runs on Windows, OSX…
Re: GitHub pages is now running Jekyll 3
#78I just found out about Lektor the other day. https://www.getlektor.com/ It's like Jekyll meets WordPress, written in Python by Armin Ronacher. He's the guy who wrote the extremely popular Python microframework, Flask. It's a static site generator with a slick React powered admin interface intended for editors (non-programmers) to use. It runs locally like any good static site generator should and runs on Windows, OSX…
Lektor looks really cool. For the life of me I don't understand why it's only in Python 2.7 though.
Unicode in Python 3 is his problem, and there was one post I can't find on mobile where he started ranting about POSIX and Unix for some unclear reason. I can't follow him on a lot of it, as much as I respect his work, because if you read objectively it's pretty clear the reasoning is often there to support a predisposition. Meanwhile, my whole stack is Python 3 and I'm having a grand old time less the pieces where I had to sub in shittier libraries, and not a single problem Armin has ever raised about Python 3 has hit us. Not one. Most of it boils down to Unicode issues that have been issues outside of Python for 20 years.
This isn't to say Python 3 is perfect. (Far from it.)
He also often writes what I like to call the "Alex Gaynor Conclusion," which is tediously enumerating in the conclusion why you're going to call him wrong in his opinions which somewhat minimizes effectively disagreeing with him. There is a subculture of people who do this, and it mildly bugs me. Nothing against him; just an observation.
Anyway, port it and drop a patch, and I'll buy you scotch. I know better than to make any request other than that, and it's cooled me on using Armin's software in general (to my disappointment; Armin's Web stack has been a trusted friend through four different employers, from Werkzeug on up, and it's a massive bummer to see Lektor confirm suspicion).
Re: GitHub pages is now running Jekyll 3
#79For every Git push to the master branch it builds and deploys the generated site to Github Pages.
Re: GitHub pages is now running Jekyll 3
#80Earlier quoted context omitted.
The nice thing about Markdown that doesn't apply to those other formats is that it's designed to read naturally in plaintext. That constraint should (in theory) prevent it from transforming into something prohibitively complicated to write in.
Except for links to images. I can never freaking remember those. Also, the silly space-at-the-end for line breaks.
I thought it was two spaces at end of line for a line break. Or did the one-space-at-end-of-line argument win?[1]
[1] http://meta.stackexchange.com/questions/40976/what-is-the-re...