Differences

This shows you the differences between two versions of the page.

--- docbook [2015/06/04 08:24]
slackermedia
+++ docbook [2021/06/03 19:48]
@@ Line 1: / Line 1: @@
-[[{arrowp.png|border:0;background:none;width:0;display:inline-block;position:absolute;top:0;left:0;}digikam|]]
-[[{arrown.png|border:0;background:none;width:0;display:inline-block;position:absolute;top:0;margin-left:2.5em;}jack|]]
-====== Docbook ======
-[[http://www.docbook.org|Docbook]] is a typesetting and layout tool for authors. Specifically, it is an XML schema intended to produce both print and electronic copies of text. Combined with any one of many powerful xml processors available, it achieves the goal of letting an author write once and publish to anything. It is widely used in technical documentation (such as the first few editions of Slackermedia itself), but also for works of fiction, academia, and more.
-<WRAP notice prewrap 50%>
-<WRAP rightalign>
-===== Strengths [Weaknesses] =====
-</WRAP>
-**Familiar**
-<WRAP indent>
-XML is vastly different than HTML, but the concept is very similar. If you are good with HTML, then XML will feel like the "pro" version of what you already know.
-</WRAP>
-**Strict**
-<WRAP indent>
-XML is rigid in what its processors accept, so there is an absolutism to how you structure your documents. This may help you organise information better, and it guarantees predictable output in the end. You won't spend time shifting indents and special meta-characters around in your text editor; you will spend time writing content within a well-structured framework.
-</WRAP>
-**Documented**
-<WRAP indent>
-XML is a long-standing format, and Docbook is a well-respected schema. Docbook is well documented on [[http://docbook.org]] and XML is so well-known that you can take classes on the subject.
-</WRAP>
-**[Ex]Portable**
-<WRAP indent>
-One your text is in XML format, it is structured and predictable. This probably means that if there is another format (html, epub, pdf, ps, plain text, rtf, odt, and so on) that you want to output to, you can convert to it from XML. There just isn't any ambiguity about XML, and heaps of post-processors.
-</WRAP>
-<WRAP rightalign>
-===== Weaknesses [Strengths] =====
-</WRAP>
-**Complex**
-<WRAP indent>
-The process of creating well-formed XML is not simple. It is a very verbose format, it will fail at the smallest error, it enforces inheritance, and it requires some number of post-processors in order to get it out of the XML format.
-</WRAP>
-**Strict**
-<WRAP indent>
-Unlike markdown or HTML, XML is intolerant of any deviation from its defined schema. Something as simple as a missing closing tag will break the processor. There are tools, such as ''xmllint'' to help ensure well-formed XML, but it is not uncommon to attempt at least three builds before a successful one.
-</WRAP>
-**Style**
-<WRAP indent>
-The look of documents output from Docbook are clean and professional, but to change the look and feel of your output, you probably need to learn XSL. XSL can be complex, especially if you have only just learnt XML and how to process it.
-</WRAP>
-</WRAP>
-<WRAP tip>
-**See Also** \\
-sphinx \\
-fountain \\
-screenwriter
-</WRAP>
-[[{arrown.png|border:0;background:none;width:0;display:inline-block;float:right;}jack|]][[{arrowp.png|border:0;background:none;width:0;float:right;}digikam|]]