--- title: "Jekyll" description: "Posts in the Jekyll category relate in some way to the static site generator jekyllrb.com, which is used to publish websites -- in my case, to build sites for documentation..." canonical_url: https://idratherbewriting.com/category-jekyll/index.html --- > For AI agents: a documentation index is available at https://idratherbewriting.com/llms.txt. Markdown versions of all pages are available by appending .md to any page URL. # Jekyll Posts in the Jekyll category relate in some way to the static site generator jekyllrb.com, which is used to publish websites -- in my case, to build sites for documentation or other content, such as blogs or online courses. Jekyll is one static site generator among many. Others include Hugo, Gatsby, Vue, Docusaurus, and more. They all work more or less the same way: they compile content, convert from Markdown to HTML, stuff the content into templates, and publish it as a website (based on the theme). The following content is in the **jekyll** category: #### [Blog and API doc course are now one site](https://idratherbewriting.com/blog/blog-and-api-doc-site-merged-same-code) | Jun 9, 2023 #### [Single-sourcing data into table templates in Jekyll](https://idratherbewriting.com/blog/single-sourcing-data-into-table-templates-jekyll/) | Jul 9, 2019 #### [Limits to the idea of treating docs as code](https://idratherbewriting.com/2017/06/02/when-docs-are-not-like-code/) | Jun 2, 2017 #### [Tutorial on converting an HTML site into a Jekyll theme](https://idratherbewriting.com/2017/04/13/jekyll-tutorial-on-converting-html-templates-to-jekyll-themes/) | Apr 13, 2017 #### [Tutorials versus docs -- why you need both](https://idratherbewriting.com/2017/03/30/tutorials-in-jekyll-docs/) | Mar 30, 2017 #### [Recording: Writing tech docs like a hacker with Jekyll](https://idratherbewriting.com/2017/01/18/writing-tech-docs-like-a-hacker-with-jekyll/) | Jan 18, 2017 #### [Markdown or reStructuredText or DITA? Choosing the right format for tech docs](https://idratherbewriting.com/2016/10/28/markdown-or-restructuredtext-or-dita-choosing-format-tech-docs/) | Oct 28, 2016 #### [How to deliver newsletters for your Jekyll site](https://idratherbewriting.com/2016/10/23/jekyll-newsletter-tip/) | Oct 23, 2016 #### [Coding the sidebar navigation element for documentation websites](https://idratherbewriting.com/2016/10/23/coding-sidebar-navigation-for-documentation-websites/) | Oct 23, 2016 #### [Presentation recording: Hunting for API developer documentation jobs in the San Francisco Bay area, by Andrew Davis](https://idratherbewriting.com/2016/08/15/api-developer-documentation-jobs-san-francisco-bay-area/) | Aug 15, 2016 #### [The complexities of translation and the need for dynamic variables in the build process](https://idratherbewriting.com/2016/08/15/translation-complexities-static-site-generations-need-dynamic-variables/) | Aug 15, 2016 #### [Advanced formatting with Markdown using Jekyll and Includes](https://idratherbewriting.com/2016/06/06/extending-markdown-in-jekyll-with-includes/) | Jun 6, 2016 #### [Slides for Writing Tech Docs Like a Hacker with Jekyll presentation](https://idratherbewriting.com/2016/05/17/slides-for-writing-tech-docs-like-hacker-with-jekyll/) | May 17, 2016 #### [Jekyll Conf 2016 slides and video: Overcoming Challenges in Using Jekyll for Tech Docs](https://idratherbewriting.com/2016/05/07/slides-for-jekyllconf-overcoming-challenges-with-jekyll/) | May 7, 2016 #### [Version 5.0 of my Documentation Theme for Jekyll now available](https://idratherbewriting.com/2016/03/23/release-of-documentation-theme-for-jekyll-50/) | Mar 23, 2016 #### [Updating from redcarpet and Pygments to Kramdown and Rouge on Github Pages](https://idratherbewriting.com/2016/02/21/bug-with-kramdown-and-rouge-with-github-pages/) | Feb 21, 2016 #### [Is the only way to plug into a documentation CCMS through DITA/XML?](https://idratherbewriting.com/2016/02/12/the-only-big-systems-manage-xml-and-dita/) | Feb 12, 2016 #### [My YAML tutorial in the context of Jekyll](https://idratherbewriting.com/2016/02/08/yaml-tutorial/) | Feb 8, 2016 #### [The problem with adopting bleeding-edge tools](https://idratherbewriting.com/2016/01/10/why-simple-tools-become-complex/) | Jan 10, 2016 #### [My upcoming 2016 STC Summit workshop and presentation](https://idratherbewriting.com/2015/12/22/upcoming-stc-summit-presentations/) | Dec 22, 2015 #### [Those pesky authoring tool questions, and an update on my adventures with Jekyll](https://idratherbewriting.com/2015/12/19/those-authoring-tool-questions/) | Dec 19, 2015 #### [Question: How long does it take to ramp up on your Jekyll theme?](https://idratherbewriting.com/2015/12/14/how-long-to-ramp-up/) | Dec 14, 2015 #### [Single sourcing the Swagger spec and main documentation using Jekyll](https://idratherbewriting.com/2015/12/03/overcoming-doc-fragmentation-with-swagger-spec/) | Dec 3, 2015 #### [Version 4.0 released for the Jekyll Documentation Theme](https://idratherbewriting.com/2015/12/03/jekyll-theme-update/) | Dec 3, 2015 #### [My pros and cons of using Jekyll for documentation](https://idratherbewriting.com/2015/11/17/pros-and-cons-of-jekyll-for-docs/) | Nov 17, 2015 #### [Can you replace a CCMS with version control such as Git or Mercurial?](https://idratherbewriting.com/2015/11/06/replace-ccms-with-version-control/) | Nov 6, 2015 #### [Why incremental regeneration in Jekyll 3.0 is such a big deal](https://idratherbewriting.com/2015/11/04/jekyll-30-released-incremental-regeneration-rocks/) | Nov 4, 2015 #### [Version 3.0 of my Documentation theme for Jekyll released](https://idratherbewriting.com/2015/08/13/version-3-jekyll-documentation-theme-released/) | Aug 13, 2015 #### [Listen to Ed Marsh's Content Content podcast with me as a guest](https://idratherbewriting.com/2015/07/08/podcast-with-ed-marsh-on-content-content/) | Jul 8, 2015 #### [How do you authenticate your documentation?](https://idratherbewriting.com/2015/06/17/how-to-authenticate-documentation/) | Jun 17, 2015 #### [Moved my blog from WordPress to Jekyll](https://idratherbewriting.com/2015/05/29/moved-my-blog-from-wordpress-to-jekyll/) | May 29, 2015 #### [Integrating Documentation into engineering code and workflows](https://idratherbewriting.com/2015/05/26/integrating-documentation-into-engineering-code-and-workflows/) | May 26, 2015 #### [Recording and slides from "Jekyll vs. DITA: Bridging the Gap Between Tech Comm and the Web" presentation](https://idratherbewriting.com/2015/05/14/recording-and-slides-from-jekyll-vs-dita-bridging-the-gap-between-tech-comm-and-the-web-presentation/) | May 14, 2015 #### [Upcoming presentation: Jekyll versus DITA: Bridging the Gap between Tech Comm and the Web](https://idratherbewriting.com/2015/05/10/upcoming-presentation-jekyll-versus-dita-bridging-the-gap-between-tech-comm-and-the-web/) | May 10, 2015 #### [Final analysis between DITA and Jekyll](https://idratherbewriting.com/2015/04/15/final-analysis-between-dita-and-jekyll/) | Apr 15, 2015 #### [Producing PDFs in DITA versus Jekyll](https://idratherbewriting.com/2015/04/14/producing-pdfs-in-dita-versus-jekyll/) | Apr 14, 2015 #### [Reviewing content in DITA versus Jekyll](https://idratherbewriting.com/2015/04/13/reviewing-markdown-content/) | Apr 13, 2015 #### [Creating links in DITA versus Jekyll](https://idratherbewriting.com/2015/04/06/creating-links-in-dita-versus-jekyll/) | Apr 6, 2015 #### [Building a table of contents with DITA versus Jekyll](https://idratherbewriting.com/2015/04/02/building-a-table-of-contents-with-dita-versus-jekyll/) | Apr 2, 2015 #### [Creating re-usable chunks (conref) in Jekyll versus DITA](https://idratherbewriting.com/2015/04/01/creating-re-usable-chunks-conref-in-jekyll-versus-dita/) | Apr 1, 2015 #### [Variables and conditional processing in Jekyll versus DITA](https://idratherbewriting.com/2015/03/26/variables-and-conditional-processing-jekyll-versus-dita/) | Mar 26, 2015 #### [Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA](https://idratherbewriting.com/2015/03/23/new-series-jekyll-versus-dita/) | Mar 23, 2015 #### [Reinventing the table of contents](https://idratherbewriting.com/2015/01/26/reinventing-the-table-of-contents/) | Jan 26, 2015 #### [Experimenting with Jekyll for tech comm](https://idratherbewriting.com/2015/01/14/experimenting-with-jekyll-for-tech-comm/) | Jan 14, 2015