TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
If you want to explore Jekyll, Tom Johnson's I'd Rather Be Writing blog has been on Jekyll for awhile now. He has a section of the site dealing with Jekyll as a documentation platform too: https://idratherbewriting.com/about-jekyll/
You may want to wait before abandoning WordPress, though. WordPress 5.0 will be coming out either in November or January. This release is centered around the new Gutenberg text editor. Gutenberg is oriented toward making blocks instead of a limited number of styles.
There is controversy in the community about whether and when Gutenberg should become the default editor, but if you don't like the current editor (TinyMCE), I suspect you'll like Gutenberg. You can play with it here: https://testgutenberg.com/
Cheers,
Mike McCallister
(co-author of a pair of editions of WordPress in Depth some time ago)
-----Original Message-----
From: techwr-l-bounces+mike -dot- mccallister=pkware -dot- com -at- lists -dot- techwr-l -dot- com <techwr-l-bounces+mike -dot- mccallister=pkware -dot- com -at- lists -dot- techwr-l -dot- com> On Behalf Of Monique Semp
Sent: Tuesday, October 16, 2018 9:25 AM
To: Lin Laurie <linlaurie1 -at- hotmail -dot- com>; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: [BULK] Re: Alternative Blog tools?
Importance: Low
> Does anyone know of a format for writing blogs other than
HTML/WordPress? I would write more blogs if I had more ability to
format things like numbered text, etc.
Jekyll is a popular SSG (static site generator) among developer types
and software-savvy writers.
You write the content in Markdown, so numbered lists are easy. But like
all Markdown-generated output, it can be very tricky/difficult to get
the spacing/leading to look decent for nested lists and the like. And
format/style options are limited when compared to a typical word
processor or other authoring tools.
But it's a good thing to learn if you're docs work is software-focused.
It'll provide a great portfolio piece that shows lots of capabilities
that hiring managers want: GitHub knowledge (you can host your site on
GitHub), Git knowledge, content organization ability, coding ability
(Markdown and build scripts), and the like.
(If these tools are new and you're looking for help, consider joining
the Write the Docs Slack network, [1]http://slack.writethedocs.org/.)
-Monique
References
1. http://slack.writethedocs.org/
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com
Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com
