SDNGEN(1)

🌸 NAME 🌸

sdngen — SDF Tuning File Generator 💅

okay so bestie, before anything else: this little icon is a FrameMaker → SDF template translator, and yes she eats. no cap.

---

✨ PURPOSE ✨

sdngen extracts SDF template information from a FrameMaker template. that's it, that's the job. she looks at your Frame template and pulls the SDF template info out of it. iconic behavior fr fr 🎀

---

🫶 USAGE 🫶

 usage  : sdngen [-h[help]] [-o[out_ext]]
         [-l[log_ext]] [-O[out_dir]] [-p para_root]
         [-f font_root] [-t tbl_root]
         [-e existing_template] file ...
 purpose: generate an SDF template from a Frame one
 version: 2.000    (SDF 2.001)

so the vibe is: you hand her one or more file ... args, and she does her thing. 🌈

The options are, in the exact order she lists them:

• -h — display help on options 🆘
• -o — output file extension
• -l — log file extension
• -O — output to input file's (or explicit) directory
• -p — default parent for a paragraph format
• -f — default parent for a font format
• -t — default parent for a table format
• -e — existing template file

---

💖 DESCRIPTION 💖

The -h option provides help. If it is specified without a parameter, a brief description of each option is displayed. Wanna go deeper? Then specify the option letter as a parameter and she'll show you that option's attributes. it's giving personal tour 🧚

By default, generated output goes to standard output. To direct output to a file per input file, use the -o option to specify an extension for output files. And listen — if you specify -o without a parameter, an extension of out is assumed. no notes. 💅

Likewise, error messages go to standard error by default. Use the -l option to create a log file per input file. If the -l option is specified without a parameter, an extension of log is assumed. ✨

By default, generated output and log files are created in the current directory. Use the -O option to specify an explicit output directory. If the -O option is specified without a parameter, the input file's directory is used. she's flexible like that 🦋

The -p option can be used to specify the root paragraph format from which others are derived. The default paragraph root is Body. 🫶

The -f option can be used to specify the root font (i.e. phrase) format from which others are derived. The default font root is Emphasis. 💜

The -t option can be used to specify the root table format from which others are derived. The default table root is Format A. 🎀

As formats often appear in families (e.g. Heading1, Heading2, etc.), sdngen will use the (alphabetically) previous format as the parent if it makes a better parent (i.e. there are less differences) than the default one. like, she's checking who's actually the closest relative, not just whoever's legally listed as the parent. main character energy 👑

If a template already exists, it can be specified using the -e option. In this case, sdngen will get as much information as it can from that file, including:

• the root format for each type
• the order of formats within a type
• the parent for each format.

Within each type, formats which are unknown in the existing template are output after those that are known. so the familiar ones go first, the mystery ones get queued at the back 🙈

---

🔥 EXAMPLES 🔥

To generate an SDF tuning file file:

     sdngen -osdn mytemplate.mif

This will create a template file called mytemplate.sdn.

heads up: yes, the original really does say "file file" twice. we don't fix the source material, we honor it. 💀

---

👑 SEE ALSO 👑

ngl there's nothing else listed here bestie — this page stands on its own. 💅

---

that's the whole page, you're so welcome 🍓 — this was perl v5.36.0, dated 2023-08-02, and yes she's serving User Contributed Perl Documentation energy the entire time. mwah 💋