Site Map - skip to main content - dyslexic font - mobile - text - print

Hobby Public Radio

Your ideas, projects, opinions - podcasted.

New episodes Monday through Friday.


hpr2378 :: Why Docbook?

Klaatu talks about why Docbook is the greatest

<< First, < Previous, Latest >>

Hosted by klaatu on 2017-09-13 is flagged as Clean and is released under a CC-BY-SA license.
Listen in ogg, spx, or mp3 format. | Comments (4)

What's so great about Docbook, any way? Glad you asked.


Comments

Subscribe to the comments RSS feed.

Comment #1 posted on 2017-09-13T02:36:01Z by Mike Ray

kramdown

I completely agree that it is impossible to write anything complex in markdown without resorting to HTML tags.

For me it's putting anchor tags around headings to provide in-page links.

But you should take a look at kramdown. Debian install:

apt-get install ruby-kramdown

Has stuff that markdown doesn't, like tables, stuff like id and class attribs for css etc.

And auto-generation of tables-of-contents

Comment #2 posted on 2017-09-13T08:17:05Z by Florian

whats so hard about code in a list?

7 spaces makes sense, it's 3 for everything belonging to the same point on you list plus 4 for the code, see experiments on
https://gist.github.com/0xf10e/91f021b82a2bc4586b235e8f56c31f92
(Yeah, "github-flavored" markdown, but it's a common dialect these days)

I still prefer three backticks, but I come from trac-wiki syntax via ReStructuredText to markdown and using single backticks for inline monospace but
{{{
Code here
}}}
in track still annoys me.

I understand the additional value semantic markup has but in many cases it's nice but not necessary.

-- sysadmin who never broke out into HTML in rst or markdown …

Comment #3 posted on 2017-09-15T10:33:15Z by Klaatu

Kramdown

Had not heard of kramdown. I'll take a look at it, for kicks, because it sounds pretty good.

Comment #4 posted on 2017-09-15T10:42:29Z by Klaatu

github markdown

I have found that Guthub markdown is a heck of a lot better than markdown. In fact, it's so significantly better that I don't see why it's not merged into markdown yet, except that as far as I can tell markdown proper is unmaintained.

The existance of Github-markdown reinforces my point: markdown needed fixing.

But I agree; sometimes docbook is overkill and [github] markdown is a better choice. If I didn't say that in this or my previous episode, I did mean to, but maybe I was blinded by docbook passion.

Leave Comment

Note to Verbose Commenters
If you can't fit everything you want to say in the comment below then you really should record a response show instead.

Note to Spammers
All comments are moderated. All links are checked by humans. We strip out all html. Feel free to
record a show about yourself, or your industry, or any other topic we may find interesting. We also check shows for spam :).

Provide feedback
Your Name/Handle:
Title:
Comment:
Anti Spam Question: What does the P in HPR stand for ?