跳转至

Getting Started

Cover

简介

您现在看到的页面是我的Github Pages项目于2024年3月7日经过Mkdocs重构之后生成的。

Github Pages是Github支持用户自主创建静态网页的工具,而Mkdocs则是由Python语言编写的,渲染Markdown文件的框架;借此我们可以快速方便地得到一个美观的网页,而省去了对Html原始网页的手动美化。

本项目创建的初衷是作为我记录那些我认为有价值被记载下来的信息的“大杂烩”,使用html语言同markdown+js插件共同制作。 其名“小拾谈记”很准确地反映了我的目的和初心:对过去经历的“再发现”。

由于我的专业为软件工程,所以该网站的大部分内容都是计算机相关的,这也反映了我“个人博客”的私心;然而我并不是十分想要望眼欲穿的计算机技术文章,这无疑是最单调无聊的事情了! 为此,我计划为网站配备其他许多有趣方面的知识;这些内容的施工进度客观地代表了我的倾向。

注释

下面的部分是对简介的一点点补充和注解:

Github Pages

我于去年年底开始接触Github Pages。我们完成的网站需要部署到服务器上:如果以自己的计算机作为服务器,则关机之后网站就无法访问,并且会把自己主机的IP地址暴露给访客; 如果租用阿里云等云服务器,那么就必须支付相应的费用; 如果使用Github Pages,则可以免费地拥有自己的静态网站,同时,缺点就是我们只能得到一个静态网页,意味着我们不能和访客发生方便地交流。

这是与Github Pages相关的文章:利用 GitHub 快速搭建一个免费个人网站 | 2022(无需编程) - 倪琛的文章 - 知乎

Material for Mkdocs

他的作用是成为一个“网页的模板”,同时避免你编写Html代码转而使用更加简洁易用的Markdown语言: 对于不想过分关注于网页格式而是文章内容的你无疑是一个利器!

这是Mkdocs的官网,其中包含了项目的详细使用文档。

同时,我还在学习过程中发现了一个相当成熟和有用的教程:工欲善其事,必先利其器 - 搭建技术博客/个人主页 - 使用MkDocs和Material - Shaun的文章 - 知乎,作者搭建了一个相当美观的网站,源代码在这里

此外,著名的信竞维基OI-Wiki也使用了Mkdocs技术,这是项目网址源代码地址