seth.computer
this repo has no description
Initial import doc, needs refinement
+33
+33
docs/import.md
+33
docs/import.md
···
1
+
# Importing existing files to standard.site records
2
+
3
+
The sitebase import commands allow you to import existing static site content into `standard.site` records in your PDS.
4
+
5
+
## Requirements for importing
6
+
7
+
- File(s) targeted must be either markdown or html, with YAML-formatter frontmatter
8
+
- Must have `contentType`, `title`, `path` and `date` properties
9
+
- Make these are specifiable in import CLI flags
10
+
- Ex: `--titleProp=title`, `--publishedAtProp=date`, `--pathProp=route`
11
+
- `--contentType=(markdown|html)`
12
+
- Also optionally support `--descriptionProp`, and `--tagsProp`
13
+
14
+
## Import process
15
+
16
+
- Use the cli [sitebase doc import](./cli.md) command.
17
+
18
+
***
19
+
20
+
# TODO
21
+
22
+
- Refine this doc, make it nicer
23
+
- Ensure the command doc in ./cli.md aligns
24
+
25
+
# QUESTIONS
26
+
27
+
### Support both `doc import` and `pub import`?
28
+
29
+
Just worry about `doc import` for now. It can target multiple files if needed.
30
+
31
+
### Do pretty much all SSGs work with files that have frontmatter data? I think so!
32
+
33
+
Enough so that I'm not worried about outliers