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
81–90 of 119 posts
Re: GitHub pages is now running Jekyll 3
#82Earlier quoted context omitted.
In case SSL support is essential to you please know that we'll looking to bring it to _GitLab_ Pages in a few months https://gitlab.com/gitlab-org/gitlab-ee/issues/134
Is GitLab pages going to be available to non-enterprise gitlab.com users? If not, may I respectfully request that it is?
Re: GitHub pages is now running Jekyll 3
#83Earlier 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.
Re: GitHub pages is now running Jekyll 3
#84Earlier quoted context omitted.
Except for links to images. I can never freaking remember those. Also, the silly space-at-the-end for line breaks.
"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...
And since my editor strips newlines on save (and no, I will not turn that feature off), I guess I can't use it.
Oh well.
It kind of scares me that I might inadvertently strip the newlines out of someone else's markdown that I'm editing, though.
Re: GitHub pages is now running Jekyll 3
#85OK, 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…
Re: GitHub pages is now running Jekyll 3
#86I 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
#87Earlier 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.
They work like standard Markdown links (text in square brackets, followed by link in parens), except you add a bang in front of it. The bang looks like an upside-down "i", the first letter of "image".
Edit: read too fast; _links_ to images use image instead of text in a link, so you just replace the text with text in square brackets with the syntax of Markdown image. I've never struggled too much with this one, so I don't have any useful mnemonics, sorry.
Re: GitHub pages is now running Jekyll 3
#88Earlier quoted context omitted.
"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...
I... never knew this. And since my editor strips newlines on save (and no, I will not turn that feature off), I guess I can't use it. Oh well. It kind of scares me that I might inadvertently strip the newlines out of someone else's markdown that I'm editing, though.
Re: GitHub pages is now running Jekyll 3
#89OK, 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…
I left the conversation at that point because I sensed it might turn ugly (it was the afternoon, and he had a penchant for boozy lunches when his boss was out of the office).
Re: GitHub pages is now running Jekyll 3
#90Good news. We're using Jekyll 3 at Static Website Manager [1], but we're moving to support older specific versions as well as custom Gemfiles. [1]: https://www.staticwebsitemanager.com Are there any features the community would love to see offered in a Jekyll-based CMS?