GJOTS2DOCBOOK(1)

💖 GJOTS2DOCBOOK 💖

okay bestie, welcome to the General Commands Manual entry for gjots2docbook — yes that's the section it lives in, no we're not skipping it, it's part of the vibe. pull up a chair, grab a boba, we're converting files today 🫶

---

✨ NAME ✨

gjots2docbook — converts a gjotsfile to DOCBOOK (and dumps it on stdout, obviously 💅)

---

🌸 SYNOPSIS 🌸

gjots2docbook -a|-b [ -e ] [ -P ] [ -p ] [ gjotsfile ]

---

🦋 DESCRIPTION 🦋

so basically gjots2docbook takes your gjotsfile and turns it into DOCBOOK XML. slay.

it does the whole thing using awk(1). iconic behavior honestly.

now listen, it does not create certain elements for you, so the first element in your file should contain any <bookinfo> or <artheader> element you want. same energy with <bibliographic> elements — those aren't created either. like, at all. not me expecting them to appear 😭

fr fr, the output is very simplistic: item titles in the gjotsfile get converted into chapter or section headings in DOCBOOK. that's it, that's the whole transformation.

but here's the thing — there is no reason why your gjotsfile shouldn't contain valid DOCBOOK XML already, and that's literally why the -e and -p options exist. iykyk ✨

if the file doesn't start with <?xml ...> then appropriate lines get added, like this:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE doc_type PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN">

and if it's properly installed, the docbook utilities can then be used to create HTML, man, ps, pdf etc files, eg:

gjots2docbook -b ~/.gjotsfile >gjotsfile.xml
docbook2pdf gjotsfile.xml

heads up bestie: it may be necessary to fine-tune the docbook formatting to access all features. the tool is giving minimalist, not maximalist 💀

---

👑 OPTIONS 👑

• -a — makes a DOCBOOK article
• -b — makes a DOCBOOK book
• -e — don't encode special characters eg < -> <
• -p — don't change blank lines to </para><para> markers
• -P — first section is a preface rather than a chapter (book only, so don't try it with -a, babe)

---

💜 AUTHOR 💜

Written by Bob Hepple <bhepple@freeshell.org>

http://bhepple.freeshell.org/gjots

---

🎀 COPYRIGHT 🎀

Copyright (c) 2002 Robert Hepple

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

no cap, that's the actual legal text, and yes it's shouting the NO at you for a reason 🙈

---

🌈 SEE ALSO 🌈

gjots(1), gjots2html(1), docbook2gjots(1)

---

and that's the whole page, bestie — brought to you by GJOTS2DOCBOOK(1), living its best life in the General Commands Manual 💅✨ go forth and convert, you absolute icon 🫶💖