yodlconverters(1)

📦
version 4.03.03 · 2 versions
, in debian bookworm, ubuntu noble

💖 yodlconverters — bestie's guide to the Yodl converter girlies 💖

okay so welcome to yodlconverters(1), which lives inside the Your Own Document Language manual, and honestly? it's giving "backstage pass to the whole converter squad." ✨

🌸 SYNOPSIS 🌸

yodl2... [OPTION]... FILE

✨ DESCRIPTION ✨

so this page is the group chat for all the little shell scripts that take your Yodl-language document and yeet it into other formats. the basic converters are:

  • yodl2html(1): converts to HTML, writes a file with the extension .html. 💅
  • yodl2man(1): converts to nroff man format, writes .man. you can keep cooking it further with e.g. nroff -Tascii -man file.man.
  • yodl2latex(1): converts to LaTeX output, writes .latex. further process with, e.g., latex file.latex. 🎀
  • yodl2txt(1): converts to plain ASCII, writes .txt. no cap, this one is a very rudimentary converter — literally the last-resort queen. 😭

👑 OPTIONS 👑

the options are identical to those of the yodl(1) program. periodt.

additionally, the following options are available:

  • --no-warnings — by default the converters call yodl(1) using the -w flag. this option suppresses that flag. bye bye warnings 🫶
  • --intermediate=<filename> — by default, files used for the communication between yodl and yodlpost are removed following the conversion. this option may be provided to retain these files, called <filename> and <filename>.idx. keep the receipts bestie 📝

🦋 FILES 🦋

each yodl2format converter requires a file format.yo in Yodl's include path (e.g., tmp/wip/macros). this file is auto-loaded before FILE (see the synopsis) is loaded, so that the conversion to format is even possible. lowkey essential.

the output is written to one or more files having the extension .format. ✨

🌈 SEE ALSO 🌈

yodl(1), yodlbuiltins(7), yodlletter(7), yodlmacros(7), yodlmanpage(7), yodlpost(1), yodlstriproff(1), yodltables(7), yodlverbinsert(1).

the whole friend group fr fr 💜

💀 BUGS 💀

-

(nothing here, the bug list is on its self-care era 🙈)

🌸 AUTHOR 🌸

Frank B. Brokken (f.b.brokken@rug.nl),

and that's the tea 🍓 this icon of a page is from yodl_4.03.03, dated 1996-2021 — slay, stan, and go convert something gorgeous 💖✨🎀

📦 where this page comes from