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 | Jun 9, 2023

Single-sourcing data into table templates in Jekyll | Jul 9, 2019

Limits to the idea of treating docs as code | Jun 2, 2017

Tutorial on converting an HTML site into a Jekyll theme | Apr 13, 2017

Tutorials versus docs -- why you need both | Mar 30, 2017

Recording: Writing tech docs like a hacker with Jekyll | Jan 18, 2017

Markdown or reStructuredText or DITA? Choosing the right format for tech docs | Oct 28, 2016

How to deliver newsletters for your Jekyll site | Oct 23, 2016

Coding the sidebar navigation element for documentation websites | Oct 23, 2016

Presentation recording: Hunting for API developer documentation jobs in the San Francisco Bay area, by Andrew Davis | Aug 15, 2016

The complexities of translation and the need for dynamic variables in the build process | Aug 15, 2016

Advanced formatting with Markdown using Jekyll and Includes | Jun 6, 2016

Slides for Writing Tech Docs Like a Hacker with Jekyll presentation | May 17, 2016

Jekyll Conf 2016 slides and video: Overcoming Challenges in Using Jekyll for Tech Docs | May 7, 2016

Version 5.0 of my Documentation Theme for Jekyll now available | Mar 23, 2016

Updating from redcarpet and Pygments to Kramdown and Rouge on Github Pages | Feb 21, 2016

Is the only way to plug into a documentation CCMS through DITA/XML? | Feb 12, 2016

My YAML tutorial in the context of Jekyll | Feb 8, 2016

The problem with adopting bleeding-edge tools | Jan 10, 2016

My upcoming 2016 STC Summit workshop and presentation | Dec 22, 2015

Those pesky authoring tool questions, and an update on my adventures with Jekyll | Dec 19, 2015

Question: How long does it take to ramp up on your Jekyll theme? | Dec 14, 2015

Single sourcing the Swagger spec and main documentation using Jekyll | Dec 3, 2015

Version 4.0 released for the Jekyll Documentation Theme | Dec 3, 2015

My pros and cons of using Jekyll for documentation | Nov 17, 2015

Can you replace a CCMS with version control such as Git or Mercurial? | Nov 6, 2015

Why incremental regeneration in Jekyll 3.0 is such a big deal | Nov 4, 2015

Version 3.0 of my Documentation theme for Jekyll released | Aug 13, 2015

Listen to Ed Marsh's Content Content podcast with me as a guest | Jul 8, 2015

How do you authenticate your documentation? | Jun 17, 2015

Moved my blog from WordPress to Jekyll | May 29, 2015

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 | May 14, 2015

Upcoming presentation: Jekyll versus DITA: Bridging the Gap between Tech Comm and the Web | May 10, 2015

Final analysis between DITA and Jekyll | Apr 15, 2015

Producing PDFs in DITA versus Jekyll | Apr 14, 2015

Reviewing content in DITA versus Jekyll | Apr 13, 2015

Creating links in DITA versus Jekyll | Apr 6, 2015

Building a table of contents with DITA versus Jekyll | Apr 2, 2015

Creating re-usable chunks (conref) in Jekyll versus DITA | Apr 1, 2015

Variables and conditional processing in Jekyll versus DITA | Mar 26, 2015

Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA | Mar 23, 2015

Reinventing the table of contents | Jan 26, 2015

Experimenting with Jekyll for tech comm | Jan 14, 2015