Guiyuan1111的小窝

2.1.1 时区问题#

字段published设置为 2025-12-25 17:45:00后，文章内显示正确

但是在归档的一栏显示错误

2.1.2 时间字段解析#

这三个字段都是依赖于published:字段，其他的字段注释掉也不影响，修改成别的时间也不会影响这三个的时间

2.4.1 API 密钥 (API Key)#

登陆之后找到设置

2.4.2 网站ID (Website ID)&跟踪脚本地址 (Tracking Script URL)#

3.1.1 沿用的标准#

Markdown 教程

3.1.2 手打规范#

1. 中文和英文之间会有一个空格

2. Front Matter（前置元数据），用来存储文章的元信息。

1
---
2
title: 测试 # 标题（需更改）
3
published: 20xx-xx-xx   # 发表时间（需更改）
4
pinned: true
5
description: xxxxx # 描述
6
tags: # 标签
7
  - xxxxx
8
category: xxxxx # 分类
9
licenseName: Unlicensed
10
author: Guiyuan1111
11
# sourceLink: https://github.com/emn178/markdown
12
draft: false
13
date: 20xx-xx-xx
14
# image:./cover.png
15
pubDate: 20xx-xx-xx
16
permalink: xx
17
---

3.2.1 Typora#

4.1.1 创建#

我需要总结完成的工作，并向用户说明PDF展示功能的使用方法。我已经成功为博客网站添加了PDF展示功能。

实现的功能：

1. 创建了PDF组件 ：
   • 文件： src/plugins/rehype-pdf-component.mjs
   • 实现了PDF文件的嵌入功能，支持自定义宽度和高度
2. 注册了PDF组件 ：
   • 在 astro.config.mjs 中导入并注册了PDF组件
   • 现在可以在Markdown中使用 :::pdf 指令来嵌入PDF文件
3. 测试了功能 ：
   • 在 src/content/posts/gypost/测试.md 中添加了PDF测试用例
   • 使用了在线PDF文件和本地PDF文件进行测试
   • 将本地PDF文件放在 public/files/ 目录下，路径为 /files/The_Year_Gone,_and_The_Year_Ahead.pdf 使用方法：

在博客文章中使用以下语法嵌入PDF文件：

1
:::pdf{src="https://example.com/file.pdf"
2
width="800px" height="500px"}
3
:::

或者使用本地文件：

1
:::pdf{src="/files/file.pdf"}
2
:::

参数说明：

• src ：PDF文件的URL或相对路径（必填）
• width ：PDF嵌入框的宽度（可选，默认为100%）
• height ：PDF嵌入框的高度（可选，默认为600px）

注意事项：

• 本地PDF文件需要放在 public/ 目录下才能被正确访问
• 浏览器中的错误信息（SyntaxError和ReferenceError）与PDF展示功能无关，不影响PDF的正常显示

4.1.2 分析#

在Markdown中， ::: 是一种容器指令语法，用于创建自定义组件。在我们的PDF展示功能中：

1. 开始标记 :::pdf{src="url" width="800px" height="500px"} ：
   • 告诉Markdown解析器这是一个名为 pdf 的自定义组件
   • 包含组件所需的属性（如 src 、 width 、 height ）
   • 这些属性会被传递给 PdfComponent 进行处理
2. 结束标记 ::: ：
   • 表示PDF组件的定义结束
   • 开始和结束标记之间可以包含内容（但在PDF组件中我们没有使用子内容） 这种语法是通过 remark-directive 和 rehype-components 插件实现的，允许我们在Markdown中轻松使用自定义组件，就像使用普通Markdown语法一样。它使我们能够扩展Markdown的功能，添加PDF嵌入、GitHub卡片、警告框等自定义内容。