跳转到内容

逍遥自在轩 | 个人主页

逍遥自在轩,采用 Astro, Starlight, Svelte, Markdown, MDX,TailwindCSS 所构建的个人主页,它快速、易用、易于访问、高度可定制;用于汇集生活和工作中频繁使用的工具、软件和服务。

🚀 项目结构

.
├── public/
├── src/
│ ├── assets/
│ ├── assets/configs
│ ├── content/
│ │ ├── docs/
│ │ └── config.ts
│ └── env.d.ts
├── astro.config.mjs
├── tailwind.config.mjs
├── package.json
└── tsconfig.json

您的链接配置位于 src/configs 目录中,这是您主要需要关注的地方,特别是在您对页面样式没有额外要求的情况下。

🏹 如何使用?

Terminal window
# clone project
git clone https://github.com/nicejade/homepage.git
cd homepage
# install dependencies
pnpm i
pnpm start

接下来您只需要按照自己的需求,修改配置即可;主要涉及文件:astro.config.mjssrc/configssrc/content/docs/*.mdx

🚀 如何部署?

Homepage  是一个完全基于静态网站构建的项目,不需要复杂的后端逻辑或数据库操作。您可以根据个人喜好选择不同的部署方式,例如使用静态网站托管服务(如 GitHub Pages、Cloudflare、Netlify)、CDN 和云存储服务、Docker 容器或虚拟主机或共享主机。我推荐使用 GitHub Pages 和 Cloudflare,它们提供免费的服务,并且部署过程简单,同时还支持 HTTPS。

🦚 诞生初衷

自 2017 年春,始筹划并倾力打造:倾城之链——此系一方汇聚环球臻选网站之所在;历经七载耕耘,不期于 2024 年早春(3 月 1 日),因在二级域名 chatgpt.nicelinks.site 部署 GPT 服务,致使整域名不得不暂(永)别江湖;历经数十番周折,终难破此局,唯叹息作罢。值此人工智能迅疾发展之际,万千网站如过江之鲫,昔日之价值,已然大不如前;惟录入日常所需,聊以自娱足矣。

忆往昔,曾购得 niceshare.site 此良域,加之对 AstroStarlightSvelte 等新锐技术怀揣钟爱之心。当此之时,诉求、良方与机缘不期而遇,遂促成逍遥自在轩之诞生。此轩寓意超然物外,意在汇集生活点滴,记录技术所思。

值得一提的是,念及数据尚在,于 2024 年深秋时节(11 月 3 日),特在 lovejade.cn 域名之下,重新部署倾城之链服务;纵然无意再作细致经营,聊以寄托对昔日多年坚持的一份追念与敬意。犹如林间清风,漫步前行,正如苏轼所言:“竹杖芒鞋轻胜马,谁怕?一蓑烟雨任平生。“

此一方小天地,承载了技术的进步,见证了时代的变迁。愿以淡泊之心,继续在这互联网的天地间,烹茶品读,静待花开。

🛠️ 自定义

鉴于本项目构建在 Starlight 之上,Homepage 提供了高度可定制的功能。您可以自定义主题、自定义 CSS 和 JS(选择您喜欢的 JS 和 CSS 框架)、自定义布局、格式化以及本地化等。如果需要更多信息,请参阅 Starlight 文档

🙌 特别鸣谢

本项目的开发过程中,依赖并受益于以下优秀的开源技术和工具(未包含全部)。它们不仅提供了强大的功能,还促进了项目的高效开发和稳定运行。

  • Astro: 作为一个静态网站生成器,Astro 允许开发者使用各种流行的前端框架和标记语言来构建网站,同时通过其群岛架构优化了网站的加载速度和性能。
  • Starlight: 作为基于 Astro 的文档主题,Starlight 提供了一系列专为文档网站设计的开箱即用功能,包括清晰的导航、主题颜色配置以及国际化支持。
  • Svelte: 一个创新的前端框架,它在构建时将模板编译成高效的 JavaScript 代码,从而减少了运行时的体积和提高了性能。
  • Markdown: Markdown 是一种简洁的标记语言,它允许开发者使用易读易写的文本格式编写内容,并最终转换成 HTML。
  • MDX: 允许您在 Markdown 内容中使用 JSX。您可以导入交互式图表或警报等组件,并将它们嵌入到您的内容中。这使得使用组件编写长篇内容变得非常有趣。
  • TailwindCSS: 一个 CSS 框架,它提供了大量的工具类,使得开发者能够快速构建出响应式和定制化的 UI 设计。
  • TypeScript: JavaScript 的超集,它引入了静态类型系统,帮助开发者在开发大型应用时提高代码的质量和开发效率。

📄 许可证

MIT

版权所有 (c) 2024-至今,逍遥自在轩