二、网站内容管理

二、网站内容管理

笔记作者:BrickLoo
内容摘要:本文记录了从搭建好基础样例页面并能正常访问后,一直到能够管理个人网站中的文章内容。本文仅包含博客文档创建和管理等操作,最后的效果是能在个人网站放入自己的文章,尚未包含样式的调整部分。

网站内容管理基本介绍

(不确定其他主题是不是这样子,但是在我使用的 Hextra 主题下,)网站的内容都以 md 格式放置在 content 目录下。参考 Hextra 主题官方模板content 目录中的内容遵循以下规则:

  • 其中的内容会根据文件地址被自动赋予链接,所以可以通过文件夹构成页面中的层级。链接会忽略特殊符号和 .md 后缀,并用 - 填充空格。为了分享链接时的美观性,建议使用英文的文件名和文件夹名,或者在文档中显式地为那个页面指定 url(见后文);
  • 对于层级结构,如果希望将“文件夹”作为一个页面,用作“目录/首页/封面”等功能,只需要在那个文件夹下创建名为 _index.md 的文件;

文章基本模板

以前一篇文章为例,个人习惯使用以下模板来进行页面的创建:

---
date: '2024-01-02'
title: '一、主题配置和部署'
prev: '/docs/个人网站搭建'
url: '/docs/build-your-site/1'
next: '/docs/个人网站搭建/二、网站内容管理'
weight: '1'
---

笔记作者:BrickLoo

## 正文大标题

开始写正文……

其中,

  • title 属性起到了 md 文件中 # 一级标题 的作用,个人习惯直接使用文件名;因此,与此对应的是,后文中最大的标题需要从 ## 开始,否则主题样式渲染的结果会看起来比较奇怪;
  • prevnext 属性用来管理页面尾部的上下页跳转按钮,属性内容是以 content 目录为根目录的文件绝对路径,个人习惯忽略 .md 后缀;
  • url 属性用于指定页面的 url;因为我的文件和文件夹选择使用中文进行命名,因此另外使用这个属性管理页面 url,提高美观度;
  • weight 属性用于控制页面的排序,数值越大排得越下/越后。同文件夹下的 md 文件会根据 weight 自动填入 prevnext 属性;但是 _index.md 文件中的这个属性是用于上一个层级的排序,因此需要自己按需设置 prevnext 属性;
  • 属性的顺序并无硬性要求,以上顺序只是个人习惯;

参考资料