seth.computer / sitebase
this repo has no description
fork atom
sitebase / docs / import.md
at design-docs 1.0 kB view raw view code
seth.computer Initial import doc, needs refinement
3db8b388

Importing existing files to standard.site records#

The sitebase import commands allow you to import existing static site content into standard.site records in your PDS.

Requirements for importing#

  • File(s) targeted must be either markdown or html, with YAML-formatter frontmatter
  • Must have contentType, title, path and date properties
    • Make these are specifiable in import CLI flags
    • Ex: --titleProp=title, --publishedAtProp=date, --pathProp=route
    • --contentType=(markdown|html)
  • Also optionally support --descriptionProp, and --tagsProp

Import process#

TODO#

  • Refine this doc, make it nicer
  • Ensure the command doc in ./cli.md aligns

QUESTIONS#

Support both doc import and pub import?#

Just worry about doc import for now. It can target multiple files if needed.

Do pretty much all SSGs work with files that have frontmatter data? I think so!#

Enough so that I'm not worried about outliers