DAPS(1)

πŸ’– DAPS-INIT πŸ’–

okay bestie, so DAPS(1) is the manual, and this one's all about daps-init β€” the lil command that sets up a whole DAPS documentation directory for you. it's giving let me build your entire project from scratch while you sit there looking pretty ✨


🌸 NAME 🌸

daps-init β€” a command to set up a DAPS documentation directory. that's it, that's the vibe πŸ’…


✨ SYNOPSIS ✨

daps-init {--docdir PATH_TO_DOC_DIR} [OPTIONS]

πŸ¦‹ DESCRIPTION πŸ¦‹

so daps-init is what you use to create a DAPS documentation project from scratch. no cap, it literally does the whole setup for you: it automatically sets up the key files and the directory structure you need, and then β€” as a little treat β€” it creates an example DocBook 4 or 5 document so you can poke around and explore what DAPS can actually do. main character energy fr fr πŸ‘‘

here's the tea on what's mandatory vs. what's just recommended, because apparently they're different:

  • Specifying the project directory with --docdir is mandatory. non-negotiable, bestie, you have to do this one.
  • All other options are optional (as the name suggests, lowkey).
  • Specifying a name for the document with --name is recommended β€” it'll be used in filenames. do it, you'll thank yourself later 🫢
  • Setting the title of the document with --title is also recommended. cute title, cute docs, iykyk 🌈

πŸ’… OPTIONS πŸ’…

  • --docdir DIR β€” the path to the project directory where the DAPS environment is gonna get set up. if that directory doesn't exist, dw, it'll be created for you. this one is mandatory, no skipping πŸ™…β€β™€οΈ
  • --dapsroot DIR β€” tells daps-init where to find the template files (the init-templates/ directory). you only need this if you installed DAPS somewhere custom, like a lil hideaway. default: /usr/share/daps
  • --date YYYY-MM-DD β€” gives a date in the format YYYY-MM-DD. it's used to set the document's publication date (that's the <date/> in the document's info section, iykyk). default: the current date (<?dbtimestamp format=\"B d, Y\"?>)
  • --docbook4 β€” make a document in DocBook 4 format. this is the default, so if you do nothing, this is what you get πŸŽ€
  • --docbook5 β€” make a document in DocBook 5 format instead. glow up ✨
  • --name NAME β€” a string that gets used in filenames (like when you're generating PDF or HTML output). only use letters, digits, dashes and underscores: [A-Za-z0-9-_]. default: daps-example
  • --productname "PRODUCT" β€” a name for the product your document is describing. it gets used in the document's subtitle (<productname/> in the info section). giving the docs a whole identity fr πŸ’–
  • --productnumber "PRODUCT_VERSION" β€” a version for the product your document describes. used in the subtitle too (<productnumber/> in the info section). requires --productname β€” so like, don't try to do this one solo, it needs its emotional support option πŸ«‚
  • --rootelement article|book β€” the DocBook root element of the example document. right now the supported ones are "book" and "article" (default is article).
  • --title "TITLE" β€” the title of the document. default: "DAPS Example"

πŸ”₯ SEE ALSO πŸ”₯


πŸ‘‘ AUTHOR πŸ‘‘

Frank Sundermeyer <fsundermeyer@opensuse.org> Developer πŸ’œ


and that's the whole page, bestie! this was DAPS @DAPS_VERSION@, dated 11/06/2025, filed under DAPS(1). slay, go build something cute πŸŒΈπŸ§šπŸ’–

πŸ“¦ where this page comes from