USAGE:(1)

💖 USAGE:(1) 💖

ok so bestie. you found the man page for usage: — it's filed under User Commands in the manual, and honestly? it's giving "tool that imports your whole blogging era into Pelican." let's get into it 🫶

---

✨ NAME ✨

usage: — import from a feed, Wordpress, or Dotclear files

---

🌸 DESCRIPTION 🌸

okay so here's the whole vibe. this is the manual page for usage:, and the actual program you're running is this:

usage: pelican-import [-h] [--blogger] [--dotclear] [--medium]
[--tumblr]

[--wpfile] [--feed] [-o OUTPUT] [-m MARKUP] [--dir-cat]
       [--dir-page] [--filter-author AUTHOR] [--strip-raw]
       [--wp-custpost] [--wp-attach] [--disable-slugs] [-b BLOGNAME]
       input

what does it do? it transforms feed, Blogger, Dotclear, Tumblr, or WordPress files into reST (rst) or Markdown (md) files. no cap. 💅

🚨 bestie listen — be sure to have pandoc installed. it's not optional, it's the whole personality of this tool.

---

🎀 positional arguments

• input — the input file to read. that's the thing you're feeding in, babes.

---

💅 options

• -h, --help — show this help message and exit. the classic. the icon. ✨
• --blogger — Blogger XML export (default: False)
• --dotclear — Dotclear export (default: False)
• --medium — Medium export (default: False)
• --tumblr — Tumblr export (default: False)
• --wpfile — Wordpress XML export (default: False)
• --feed — Feed to parse (default: False)
• -o OUTPUT, --output OUTPUT — output path (default: content)
• -m MARKUP, --markup MARKUP — output markup format (supports rst & markdown) (default: rst)
• --dir-cat — put files in directories with categories name (default: False)
• --dir-page — put files recognised as pages in "pages/" subdirectory (blogger and wordpress import only) (default: False)
• --filter-author AUTHOR — import only post from the specified author (default: None)
• --strip-raw — strip raw HTML code that can't be converted to markup such as flash embeds or iframes (wordpress import only) (default: False)
• --wp-custpost — put wordpress custom post types in directories. if used with the --dir-cat option, directories will be created as /post_type/category/ (wordpress import only) (default: False)
• --wp-attach — (wordpress import only) download files uploaded to wordpress as attachments. files will be added to posts as a list in the post header. all files will be downloaded, even if they aren't associated with a post. files will be downloaded with their original path inside the output directory. e.g. output/wpuploads/date/postname/file.jpg — requires an internet connection — (default: False)
• --disable-slugs — disable storing slugs from imported posts within output. with this disabled, your Pelican URLs may not be consistent with your original posts. (default: False)
• -b BLOGNAME, --blogname BLOGNAME — blog name (Tumblr import only) (default: None)

---

🦋 the little repeat block

so this section in the original literally just re-prints the same argument soup again — iconic behaviour honestly, it ate:

[--wpfile] [--feed] [-o OUTPUT] [-m MARKUP] [--dir-cat]
       [--dir-page] [--filter-author AUTHOR] [--strip-raw]
       [--wp-custpost] [--wp-attach] [--disable-slugs] [-b BLOGNAME]
       input

and if you forget your input, you get this absolute mood:

pelican-import: error: the following arguments are required: input

😭 not the tool calling you out for not passing an argument. it's giving "you had ONE job." anyway, pass input. periodt.

---

and that's the whole page bestie!! this was USAGE:(1) from User Commands, version-y bits reading usage: pelican-import [-h] [--..., dated January 2025, filed back under USAGE:(1). mwah, go import something cute 💖🎀✨