![]() However, note that if you use Ruby plugins, you can’t directly host the source files on Github Pages because Github Pages doesn’t allow Ruby plugins. You can use any jQuery plugins you and other JavaScript, CMS, or templating tools. Although the experience working on the command line is better on a Mac, Windows also works, especially now that Jekyll 3.0 dropped dependencies on Python, which wasn’t available by default on Windows. ![]() You upload your files to a version control system such as Github. This appears as news and is intended to promote news that applies across products. The community for your Jekyll site isn’t so much other tech writers (as is the case with DITA) but rather the wider web development community. ![]() See this tutorial for details on how to create your own Jekyll theme. Jekyll is built on the modern web development stack rather than the XML stack (XSLT, XPath, XQuery). If you have a UX team, they can really skin and design the site using all the tools familiar to the modern designer – JavaScript, HTML5, CSS, jQuery, and more. You can skin your Jekyll site to look identical to pretty much any other site online. All of the building is done on your own machine, and you then push the static HTML files onto a server. You don’t need a LAMP stack (Linux, Apache, MySQL, PHP) architecture to get your site running. I recommend that you use smaller repos in your content architecture. It really depends on how many for loops you have iterating through the pages. Note that when your project has thousands of pages, the build time will be longer (maybe 1 minute per thousand pages?). You can choose what you display at first, second, third, fourth, and more levels, etc. It’s up to you to determine how you will design the information architecture for your pages. ![]() (You don’t need a CMS.) Because you’re working with text file formats, you can use any version control software (Git, Mercurial, Perforce, Bitbucket, etc.) as a CMS for your files. You collaborate with Jekyll projects the same way that developers collaborate with software projects. Note that this theme isn’t structured well to accommodate translation projects. You can translate the Markdown source if your translator accepts the format, but usually Markdown is problematic. To translate content, send the generated HTML to your translation group. Uses Bootstrap framework for responsive design. Where HTML falls short, you use Liquid, which is a scripting that allows you to incorporate more advanced logic. Where Markdown falls short, you can use HTML. This is a wiki-like syntax for HTML that you can probably pick up in 10 minutes. You can author content using Markdown syntax, specifically kramdown. In DITA speak, this includes conref and keyref. You can re-use variables, snippets of code, entire pages, and more. The following table shows what is supported in Jekyll and this theme.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |