ODFBUILD(1p)

✨ odfbuild — OpenDocument file creation utility ✨

okay bestie, listen up 💖 this is odfbuild, a user-contributed Perl situation that literally makes OpenDocument files for you. no GUI, no dragging icons around, just vibes and a command line. iykyk. 🦋

---

🌸 SYNOPSIS 🌸

like, here's the vibe check on how you actually run this thing:

odfbuild filename.odt

odfbuild filename.odt --title "My Document" --subject "Test"

odfbuild filename.ods --class spreadsheet --source "data.csv"
--tablesize "8x16"

cat data.txt | odfbuild filename.odt -

see her? she's flexible. she eats a filename, she takes options, and she can even slurp from stdin like the icon she is. 💅

---

🎀 OPTIONS 🎀

every single one of these, no skips, no skimming, periodt:

• --class — what kind of document are we making?? the choices are text, spreadsheet, drawing, or presentation. default: text. lowkey important.
• --opendocument — no value needed, it's just on or off. if it's ON, the doc comes out in OpenDocument format. if you don't use it, the format gets picked based on the general config of your OpenOffice::OODoc installation. so like… it's giving "let the install decide." 🙈
• --creator — the author of the document, the main character of this file. default: the current user's login name. slay.
• --date — the creation date. default is current local time. but if you do provide it, it must be in ISO-8601 format: YYYY-MM-DDTHH:MM:SS. no cute date formats, bestie, she's strict about this one. 😭
• --description — the description (aka the abstract) of the document. default: none. so nothing. empty. void.
• --force — no value, just a vibe. if it's ON, any existing file at the same path as your target file gets replaced. if you don't turn this on and the target already exists, the program will fail. so like… be careful, that's a whole file you're deleting. 💀
• --generator — the software signature stored in the file. not visible to the end user, it's just for the record, behind the scenes, sneaky. default: "Genicorp OpenOffice::OODoc <version>"
• --keywords — a list of comma-separated keywords. default: none.
• --source — a text file used as the content of the document. here's the tea on how she handles it:
  • if the document class is 'text', every line is loaded as a new paragraph with the standard style.
  • if the document class is 'spreadsheet', the file is processed as CSV data and loaded into one sheet.
  • if the document class is neither 'text' nor 'spreadsheet', the file is not processed. sorry. 😭
  • if source = '-', or if a '-' argument is provided, the data file is read through standard input. pipes, bestie! 🫶
• --subject — the subject of the document. default: none.
• --tablename — the name of the sheet to be created, but only if the document class is 'spreadsheet' AND a data file is provided. default: the name of the data file, or "Unnamed Sheet" if the data is read from standard input. she's naming things for you, so generous. 👑
• --tablesize — the size of the sheet to be created, only when the document class is 'spreadsheet' and a data file is provided. it's in 'HxW' format where H is the number of lines and W is the number of columns. default: '16x8'. yes it's H then W, read it carefully, do not come for me. 🍓
• --title — the title of the document. default: "Untitled". very demure, very mindful, very untitled.
• --readable_XML — no value. for debugging only, bestie, this is not your everyday option. if it's ON, the XML content of the target file gets indented so you can edit it later. it's giving "developer hours." 🔥

heads up: --opendocument, --force and --readable_XML take no value at all. don't try to feed them one, they don't eat. 🧚

---

🌈 that's it, that's the page 🌈

go forth and build your OpenDocuments, you absolute icon. no cap. ✨

---

this page was served fresh from perl v5.34.0 on 2022-06-16, and it's part of the User Contributed Perl Documentation collection. mwah. 💜💖🦋🌸🎀💅