$ hugo server
浏览器打开访问:http://localhost:1313
初次使用请仔细阅读
- nebula-website/ -------------------------------------- 官网项目名称
- content/ ---------------------------------------- 博客文章文件夹
- en/posts/ --------------------------------- 英文博客文件夹
- sample/ ---------------------------- 每篇文章需要创建一个文件夹,文件夹名将会决定文章的路径(比如:https://nebula-graph.io/en/posts/sample/)
- *.(jpg,png,jpeg) --------------- 每篇文章可放一张图片作为头图,请别将文章中图片放在此处引用,避免浏览费用,其他图片放github引用或者oss)
- index.md --------------------- 博客文章固定命名
- sample/ ---------------------------- 每篇文章需要创建一个文件夹,文件夹名将会决定文章的路径(比如:https://nebula-graph.io/en/posts/sample/)
- cn/posts ---------------------------- 中文博客文件夹
- en/posts/ --------------------------------- 英文博客文件夹
- config.toml -------------------------------- 官网模板的参数设置(title/meta/文案/连接/导航等)
- 其他 ---------------------------------------- 大家暂时不需要更新,也避免改动
- content/ ---------------------------------------- 博客文章文件夹
写博客文章,都需要先在分支进行修改,然后提PR
nebula-website/content/
详细信息可参照已有的文章规律
每篇文章文件夹下的index.md,都会有这样一段信息格式:
---
title: "xxx" // 标题meta
data: 2020-10-10 // 日期
descrpiton: xxxx // 这个描述会用于分享时的文案,所以保证简介达意。
// 根据需要后续还会增加,目前暂时只有这三个
---
上面这段信息填写是方便进行博客时间线排列及SEO优化的,请务必填写,保证准确简洁。
我们的文章编写,以makrdown格式来进行,具体排版大家可以拟定一个规则,站点会自动帮你做渲染。
只要你本地已经通过 hugo server
命令启动了服务,每次文章编写进行保存操作后,访问的页面会自动刷新,本地能实时预览效果。
本站点已经实现发布自动化,只需要将相应的分支修改提PR到主库master,一旦合并完成会自动发布文章到官网。
以上就是关于文章发布的全部内容,有关官网的反馈,欢迎各位提issue,当然也鼓励各位通过google搜索关键词能自我解决和学习😬。
- 关于表格:为了实现手机和网站预览能达到好的效果和适配,大家最好在本地绘制表格,然后导出成图片,这样在手机上预览比较友好。
- 关于不熟悉git等命令的同学:可以直接在github上在线编辑发布文档,只是要注意PR合并后看下站点渲染是否正常。