本仓库存放了生如夏花知识库的文档和源代码,托管在 Netlify 建站服务上。
本地环境要求 Node 12.x 或更高。
git clone [email protected]:viva-la-vita/wiki.git
cd wiki
npm i
npm run develop
访问 http://localhost:8000/ 即可看到网页。对本地源代码进行修改时网页会自动重载。
页面由 React 渲染,页面模板在 src/pages/{mdx.slug}.js
中定义。对于每一个 docs/
目录下的 MDX 文档,首先用 GraphQL 获取元数据和内容,然后在 BlogPost
组件中渲染。BlogPost
中调用的 Layout
组件在 src/components
中定义,样式在 src/styles
中定义。
docs/
下的 MDX 文档由 Netlify CMS 来管理。要在本地运行该系统,首先在 static/admin/config.yml
中将 local_backend: true
取消注释,然后将 publish_mode: editorial_workflow
注释掉;同时在另一个终端窗口运行 npx netlify-cms-proxy-server
启动本地文件服务器。然后可以在内容管理页面(http://localhost:8000/admin/)看到所有内容。
- 「文章」集合对应的是
docs/
目录下的文章 - 「元数据」集合中「目录」文件对应的是
contents.yml
,它指定了侧边栏的目录