{"id":25510194,"url":"https://github.com/slatedesign/slate-blog","last_synced_at":"2025-04-10T14:56:00.837Z","repository":{"id":273892377,"uuid":"920124485","full_name":"SlateDesign/slate-blog","owner":"SlateDesign","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-17T15:54:32.000Z","size":192,"stargazers_count":43,"open_issues_count":1,"forks_count":14,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-17T16:45:16.881Z","etag":null,"topics":["astro","blog","blog-template","frontend","markdown","minimal-blog","obsidian","static-site","tailwindcss","typescript","webdev"],"latest_commit_sha":null,"homepage":"https://slate-blog-demo.vercel.app","language":"XSLT","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SlateDesign.png","metadata":{"files":{"readme":"README-zh_CN.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-21T15:54:29.000Z","updated_at":"2025-03-17T15:54:35.000Z","dependencies_parsed_at":"2025-01-23T16:24:59.236Z","dependency_job_id":"4307e7a6-ea9d-49d3-9c04-7d8e094293c1","html_url":"https://github.com/SlateDesign/slate-blog","commit_stats":null,"previous_names":["slatedesign/slate-blog"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SlateDesign%2Fslate-blog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SlateDesign%2Fslate-blog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SlateDesign%2Fslate-blog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SlateDesign%2Fslate-blog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SlateDesign","download_url":"https://codeload.github.com/SlateDesign/slate-blog/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248239322,"owners_count":21070700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astro","blog","blog-template","frontend","markdown","minimal-blog","obsidian","static-site","tailwindcss","typescript","webdev"],"created_at":"2025-02-19T09:28:38.701Z","updated_at":"2025-04-10T14:56:00.793Z","avatar_url":"https://github.com/SlateDesign.png","language":"XSLT","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Slate blog\n\n[English](./README.md) · 中文\n\n## 我们为什么创作这样一个博客主题\n我们热爱写作与分享，也很欣赏精致的互联网产品。正因如此，我们创作了这个简洁的博客主题，它专注于内容本身，提供流畅、纯粹的写作与阅读体验。而基于各种现代的技术栈，也让其更快速、轻便和高效。\n\n它还能与 [Obsidian](https://obsidian.md/) 无缝结合，你可以轻松将笔记转化为精致的博客文章。\n\n## ✨ 特性\n\n- 简洁优雅的设计\n- 移动端适配\n- 支持 `light` 和 `dark` 颜色模式\n- 0 基础快速配置和部署\n- 支持文章草稿，本地允许预览，生产构建自动过滤\n- 支持 RSS 订阅和 Follow 认证\n- 支持 Algolia 搜索\n- 完善的 SEO 支持\n\n## 🪜 框架\n\n- Astro + React + Typescript\n- Tailwindcss + @radix-ui/colors\n  - 支持 [Tailwind CSS v4.0](https://tailwindcss.com/blog/tailwindcss-v4) (Jan 10, 2025)\n- Docsearch\n\n## 🔨 使用\n\n```bash\n# 启动本地服务器\nnpm run dev\n# or\nyarn dev\n# or\npnpm dev\n\n# 构建\nnpm run build\n# or\nyarn build\n# or\npnpm build\n```\n\n\u003e 如果你 Fork 仓库后，并将仓库设置为私有，默认会失去与上游仓库关联，可以通过运行 `pnpm sync-latest` 同步 Slate Blog 最新版本代码。\n\n## 🗂 目录\n\n```\n- plugins/            # 自定义插件\n- src/\n  ├── assets/         # 图片文件\n  ├── components/     # 组件\n  ├── content/        # 内容\n  ├── helpers/        # 业务逻辑\n  ├── pages/          # 页面\n  └── typings/        # 通用类型\n\n```\n\n## 配置\n\n通过根目录下的 `slate.config.ts` 进行主题配置。\n\n| 选项 | 说明 | 类型 | 默认值 |\n| --- | --- | --- | --- |\n| site | 最终部署的链接 | `string` | - |\n| title | 网站标题 | `string` | - |\n| description | 网站描述 | `string` | - |\n| lang | 语言 | `string` | `zh-CN` |\n| theme | 主题 | `{ mode: 'auto' \\| 'light' \\| 'dark', enableUserChange: boolean }` | `{ mode: 'auto', enableUserChange: true }` |\n| avatar | 头像 | `string` | - |\n| sitemap | 网站 sitemap 配置 | [SitemapOptions](https://docs.astro.build/zh-cn/guides/integrations-guide/sitemap/) | - |\n| readTime | 是否显示阅读时间 | `boolean` | `false` |\n| lastModified | 是否显示最后修改时间 | `boolean` | `false` |\n| algolia | docsearch 配置 | `{ appId: string, apiKey: string, indexName: string }` | - |\n| follow | follow 订阅认证配置 | `{ feedId: string, userId: string }` | - |\n| footer | 网站底部配置 | `{ copyright: string }` | - |\n| socialLinks | 社交链接配置 | `{ icon: [SocialLinkIcon](#SocialLinkIcon), link: string, ariaLabel?: string }` | - |\n\n### SocialLinkIcon\n\n```ts\ntype SocialLinkIcon =\n  | 'dribbble'\n  | 'facebook'\n  | 'figma'\n  | 'github'\n  | 'instagram'\n  | 'link'\n  | 'mail'\n  | 'notion'\n  | 'rss'\n  | 'threads'\n  | 'x'\n  | 'youtube'\n  | { svg: string }\n```\n\n### algolia 申请\n\n1. 部署网站\n2. 在 [Algolia](https://docsearch.algolia.com/apply/) 申请应用 `apiKey`\n3. 申请完成后且通过，在 `slate.config.ts` 中配置 `algolia` \n4. 重新部署网站\n\n### Follow 订阅认证\n\n1. 注册 [Follow](https://follow.is/) 账号\n2. 部署站点\n3. 在 Follow 点击 `+` 号，选择 `RSS` 订阅，填入 `rss` 链接，一般为 `[site]/rss.xml`, `site` 为 `slate.config.ts` 配置文件中 `site` 的值。\n4. 重新部署网站\n\n\n## 文章 frontmatter 说明\n\n| 选项 | 说明 | 类型 | 是否必须 |\n| --- | --- | --- | --- |\n| title | 文章标题 | `string` | 是 |\n| description | 文章描述 | `string` | 否 |\n| tags | 文章标签 | `string[]` | 否 |\n| draft | 是否是草稿，当不传或者为 `false` 时，`pubDate` 必须传；草稿仅本地预览可见 | `boolean` | 否 |\n| pubDate | 文章发布时间 | `date` | 否，当 `draft` 为 `false` 时，必须传 |\n\n**详细可以查看 `src/content/config.ts` 文件**\n\n### 示例\n\n```md\n---\ntitle: 40 questions\ndescription: This repo maintains revisons and translations to the list of 40 questions I ask myself each year and each decade.\ntags:\n  - Life\n  - Thinking\n  - Writing\npubDate: 2025-01-06\n---\n```\n## Markdown 语法支持\n\n除了标准的 Markdown 语法外，我们还支持部分扩展语法。\n\n### 基础语法\n- 标题、列表、引用、代码块等基础语法\n- 表格\n- 链接和图片\n- **粗体**、*斜体*和~删除线~文本\n\n### 扩展语法\n#### 容器\n使用 `:::` 标记\n  ```md\n  :::info\n  这是一个信息提示\n  :::\n  ```\n\n#### LaTeX 数学公式\n  - 行内公式: $E = mc^2$\n  - 块级公式: $$ E = mc^2 $$\n\n#### 支持图片说明\n  ```md\n  ![Image caption](image-url)\n  ```\n  \n## 更新日志\n### 版本 1.3.0\n- 支持显示社交链接\n- 优化 RSS 生成\n- 添加同步最新版本脚本\n\n### 版本 1.2.0\n- 支持多语言（中文和英语）\n- 修复已知问题\n\n### 版本 1.1.1\n- 修复已知问题\n\n### 版本 1.1.0\n- 升级支持 [Tailwind CSS v4.0](https://tailwindcss.com/blog/tailwindcss-v4)\n- 支持深色模式\n- 修复已知问题\n\n## Star\n\n[![Star History Chart](https://api.star-history.com/svg?repos=SlateDesign/slate-blog\u0026type=Date)](https://www.star-history.com/#SlateDesign/slate-blog\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslatedesign%2Fslate-blog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslatedesign%2Fslate-blog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslatedesign%2Fslate-blog/lists"}