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 (9)

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.

Comment #5 posted on 2017-10-06T06:08:18Z by clacke

SGML

You seemed unclear on what SGML is, so here's a quick summary:

SGML, to tell a simplifying lie, is the idea of using tag names enclosed in less-than and greater-than characters to mark up text. The original DocBook is one application, HTML is another.

XML is a further evolution of SGML, which both constrains and extends SGML to enable new ways of defining and working with applications of the format.

The counterpart of XML Schema in SGML is the DTD, the Document Type Definition, and the counterpart of XSL is DSSSL, which is a form of Scheme (yay!).

Comment #7 posted on 2017-10-17T07:13:04Z by Bob Jonkman

Referenced your podcast in our NonProfit SysAdmin meeting

I conveniently listened to your podcast just before going to the KWNPSA (Kitchener Waterloo NonProfit SysAdmin) meeting on "Markup Languages and Note Taking", where I took notes for the meeting. I added the podcast as one of the resources.

Thanx for telling us about DocBook and some other markup languages!

--Bob.

Comment #8 posted on 2017-10-17T07:17:24Z by Bob Jonkman

Should have provided a link to the KWNPSA meeting

I should have provided a link to the meeting notes for our KWNPSA meeting on Markup Languages and Note Taking:

https://sobac.com/wiki/Markup_Languages_and_Note_Taking/Meeting_Notes_2017-10-16

Maybe the HPR comment daemons can just append that link to my previous comment...

--Bob.

Comment #9 posted on 2017-11-07T05:32:42Z by Klaatu

KWNPSA

I took a look at the page, Bob. Good stuff! One addition - there's a missing entry in your text editors section: GNU Emacs.

Probably just an oversight.

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 ?
Are you a spammer →
Who hosted this show →
What does HPR mean to you ?