To ease the authoring process, content write creates a preview of your content on localhost:3000. The preview comes\nwith a basic content navigation tree (left), table of contents (right), and prose formatting (center).
This website, the current one you're looking at right now is the result of contented write.
Generates the static preview website that can be published to GitHub Pages, Netlify, or Vercel! Minimally, you need to\nconfigure your package.json with these fields:
package.json:
{\n \"scripts\": {\n \"generate\": \"contented generate\"\n },\n \"devDependencies\": {\n \"@birthdayresearch/contented\": \"latest\"\n }\n}contented.config.js:
/** @type {import('@birthdayresearch/contented').ContentedConfig} */\nmodule.exports = {\n preview: {\n url: 'https://contented.dev',\n name: 'Contented',\n github: {\n url: 'https://github.com/BirthdayResearch/contented',\n },\n },\n processor: {\n pipelines: [\n {\n type: 'Doc',\n pattern: '**/*.md',\n processor: 'md',\n },\n ],\n },\n};Netlify TOML:
\n[build]\npublish = \".contented/.preview/out\"\ncommand = \"npm run generate\"Vercel Settings:
\nFRAMEWORK PRESET = Next.js\nBUILD COMMAND = npm run generate\nOUTPUT DIRECTORY = .contented/.preview/outGenerates the ./dist output that can be published into the NPM registry for creating a derivative site. Minimally, you\nneed to configure your package.json with these fields:
{\n \"name\": \"@your-scope/your-npm-package\",\n \"files\": [\"dist\"],\n \"main\": \"dist/index.js\",\n \"scripts\": {\n \"build\": \"contented build\"\n },\n \"devDependencies\": {\n \"@birthdayresearch/contented\": \"latest\"\n }\n}Run contented build to compiled your markdown into index.js and *.json, output to the dir: ./dist.\nYou can npm publish into any registry of your choice. You can easily npm i @your-scope/your-npm-package and use the\nprocessed content on any downstream site.
import { Index } from '@your-scope/your-npm-package';The anatomy of a contented package, with just 2 configuration files, and you are good from the get-go! Contented\nautomatically ignore files in your .gitignore and .contentedignore.
\n\nYou should also add a
\n.gitignoretoo withecho \"dist\\n.contented\" > .gitignore. (Okay fine! 3 files it is. Ughhhh)
contented.config.jsexport interface ContentedConfig {\n preview: {\n url?: string;\n name?: string;\n github?: {\n url?: string;\n };\n };\n processor: {\n /**\n * The root directory of your contented markdown.\n */\n rootDir?: string;\n /**\n * Customize the output path. Editing this will cause contented-preview to break.\n */\n outDir?: string;\n /**\n * Contented processing pipeline\n */\n pipelines: Pipeline[];\n };\n}\n\nexport interface Pipeline {\n type: string;\n pattern: string;\n processor: 'md';\n fields?: {\n [name: string]: PipelineField;\n };\n transform?: (file: FileContent) => Promise<FileContent>;\n}/** @type {import('@birthdayresearch/contented').ContentedConfig} */\nmodule.exports = {\n preview: {\n url: 'https://contented.dev',\n name: 'Contented',\n github: {\n url: 'https://github.com/BirthdayResearch/contented',\n },\n },\n processor: {\n pipelines: [\n {\n type: 'Docs',\n pattern: 'docs/**/*.md',\n processor: 'md',\n fields: {\n title: {\n type: 'string',\n required: true,\n resolve: (s) => s ?? 'Contented',\n },\n description: {\n type: 'string',\n },\n tags: {\n type: 'string[]',\n },\n },\n transform: (file) => {\n file.path = file.path.replaceAll(/^\\/docs\\/?/g, '/');\n file.sections = file.sections.slice(1);\n return file;\n },\n },\n {\n type: 'Lorem',\n pattern: 'lorem/**/*.md',\n processor: 'md',\n fields: {\n title: {\n type: 'string',\n },\n },\n transform: (file) => {\n file.sections = file.sections.slice(1);\n return file;\n },\n },\n ],\n },\n};