Shiina-Astro-Blog

这是一个 Astro 静态博客生成器，大部分 UI 无法自定义，可以将本项目视为一个较大型博客的模板，参考各个页面的规划与思路，并制作属于自己的理想博客

博客页面分类参考的是 hexo 的页面分类，主题部分参考了 fluid 主题

项目结构

|-- .github                 //  GitHub 静态页面部署工作流
|-- .vscode                 // 无用
|-- docs                    // 文档
|   |-- dev                 // 开发文档
|   |-- task                // todolist
|   |-- user                // 用户手册
|-- json-server             // 数据模拟服务器
|-- public                  // 静态资源，推荐博客图片放置于此
|-- source                  // 资源文件夹
|   |-- _inject             // 注入 js， css
|       |-- _page-ssr.scss  // 全局 css 注入
|       |-- _page.js        // 全局 js 注入
|-- src
    |-- env.d.ts
    |-- assets              // 静态资源
    |-- components          // 组件
    |-- constant            // 全局常量
    |-- content             // 内容，编写文章需在此处编写
    |   |-- about           // 关于页，该文章不可删除
    |   |-- blog            // 博客，所有的文章均放在此处
    |   |-- friends         // 好友页下方说明，一般可以写申请友链的条件，文章不可删除，但可以设置为空以隐藏
    |-- declare             // 全局声明文件
    |-- layouts             // 全局布局
    |-- pages               // 博客页面划分，当制作了自定义页面后可以到该文件夹下查找 index.astro 进行引入
    |-- styles              // 全局样式
    |-- tests               // 测试，暂时没有编写
    |-- utils               // 全局方法
    |-- _bin                // 命令行工具
    |-- _custom             // 自定义主页，两个示例主页放置于此
    |-- _intergration       // Astro 集成

页面规划

接下来将对各个页面进行一个简单的功能说明

主页

位置：src/pages/index.astro

这是一个由使用者自定义的部分，可以考虑自行集成主页到博客内，集成到博客意味着你可以使用 Astro 的 api 将自己的文章列表或个人信息渲染出来

如果想要尝试渲染自己的博客到主页，可能需要对 Astro 框架进行一定的学习，接下来提供一些必备的知识链接，按顺序看即可

• Astro 组件：https://docs.astro.build/zh-cn/core-concepts/astro-components/
• 内容集合(EN): https://docs.astro.build/zh-cn/guides/content-collections/

其中内容集合部分目前 (2023/2/10) 是全英文，阅读起来难度可能有点大

目前可能会计划重构第二个模板主页，到时候会制作一个主页渲染博客文章列表的示例

如果不需要主页可以前往 blog.config.ts 进行设置，将：WebsiteSettings.useIndex 设置为 false 即可

具体可以移步 配置 文档查看

博客页

位置：src/pages/[page].astro

博客文章列表页，一般不需要动

归档、标签页

位置：src/pages/tags

其内部详情页在：src/collect/ 下

一般不动

友链

位置：src/pages/friends

一般不动

关于

位置：src/pages/about

内容根据 src/content/about 生成

一般不动

搜索

位置：src/pages/search

一般不动

下一步？

配置你的博客：点击跳转