当前位置: 首页 > 科技观察

使用pelican和Githubpages搭建博客

时间:2023-03-17 11:34:50 科技观察

今天说说我的博客是怎么搭建的。在我们开始之前,希望您熟悉使用Github并能够搭建Python虚拟环境进行开发。如果您做不到,我建议您查看DjangoGirls教程,其中涵盖了上述内容以及更多内容。这是一个帮助您发布托管在Github上的个人博客的教程。为此,您需要一个普通的Github用户帐户(不是项目帐户)。您需要做的第一件事是创建一个Github存储库,您可以在其中放置代码。如果您希望您的博客仅指向您的用户名(如rsip22.github.io)而不是子文件夹(如rsip22.github.io/blog),则必须创建一个具有全名的存储库。Github的屏幕截图,打开菜单以创建一个新存储库,创建一个名为“rsip22.github.io”的新存储库我建议您使用README、Python的.gitignore和免费软件许可证初始化您的存储库。如果你使用自由软件许可证,你仍然拥有代码,但你将它提供给其他人,让他们学习和重用它,更重要的是,让他们享受代码。现在仓库已经创建好了,我们把它克隆到本机将要保存代码的文件夹:$gitclonehttps://github.com/YOUR_USERNAME/YOUR_USERNAME.github.io.git并切换到新的Directory:$cdYOUR_USERNAME.github.io由于GithubPages更喜欢运行的方式是从master分支提供文件,所以你必须将你的源代码放入新分支,以防止Pelican生成的静态文件被导出到master分支.为此,您必须创建一个名为source的分支。$gitcheckout-bsource创建这个虚拟环境(virtualenv),并在你的系统上安装Pyhton3。在GNU/Linux系统上,命令可能是:$python3-mvenvvenv或类似这样的东西:$virtualenv--python=python3.5venv并激活它:$sourcevenv/bin/activate在虚拟环境中,你需要安装pelican及其依赖项。您还应该安装ghp-import(帮助我们发布到Github)和Markdown(使用markdown语法编写文章)。运行以下命令:(venv)$pipinstallpelicanmarkdownghp-import完成后,您可以使用pelican-quickstart开始创建您的博客:(venv)$pelican-quickstart这将提示我们一系列问题。在回答他们之前,请看下面我的回答:>你想在哪里创建你的新网站?[.]./>这个网站的标题是什么?Renata的博客>谁将成为该网站的作者?Renata>该网站的默认语言是什么?[pt]zh>是否要指定URL前缀?例如,http://example.com(Y/n)n>你想启用文章分页吗?(Y/n)y>你想要每页多少篇文章?[10]10>你所在的时区?[Europe/Paris]America/Sao_Paulo>是否要生成Fabfile/Makefile来自动生成和发布?(Y/n)Y**#注意这个!**>你想要一个自动重新加载和简单的HTTP脚本来协助主题和网站开发吗?(Y/n)n>您想使用FTP上传您的网站吗?(y/N)n>您想使用SSH上传您的网站吗?(y/N)n>您想使用Dropbox上传您的网站吗?(y/N)n>您想使用S3上传您的网站吗?(是/否)n>您想使用RackspaceCloudFiles上传您的网站吗?(y/N)n>您想使用GitHubPages上传您的网站吗?(y/N)y>这是你的个人页面(username.github.io)吗?(是/否)是完成。你的新项目位于/home/username/YOUR_USERNAME.github.io关于时区,应该指定为TZ时区(这里是完整列表:tz数据库时区列表)现在,继续往下并开始创建你的第一篇博文!您可能想在您喜欢的代码编辑器中打开项目目录,并在其中找到内容文件夹。然后新建一个文件,可以命名为my-first-post.md(不用担心,这只是为了测试,以后可以更改)。在文章内容之前,它应该以元数据开头,元数据标识标题、日期、目录等,如下所示:.lang="markdown"#不要复制这一行,它的存在只是为了突出显示标题:我的第一篇文章发布日期:2017-11-2610:01修改时间:2017-11-2712:30分类:misc标签:first,miscSlug:My-first-post作者:你的名字总结:你的帖子说的是什么?写在这里。这是我的Pelican博客中的*第一篇文章*。**耶!**让我们看看它是什么样子?进入终端,生成静态文件并启动服务器。为此,请使用以下命令:(venv)$makehtml&&makeserve当此命令运行时,您应该能够通过在您最喜欢的网络浏览器的地址栏中键入localhost:8000来访问它。博客首页截图。它有一个带有Renata博客标题的标题,左侧是第一篇博文,右侧是帖子的信息,底部是链接和社交。很整洁,对吧?现在,如果你想在帖子中放一张图片,我应该怎么做?好吧,首先您在放置文章的内容目录中创建一个目录。为了便于参考,我们将此目录命名为image。现在你必须让鹈鹕使用它。找到pelicanconf.py文件,这个文件是你配置系统的地方,并添加一个包含你的图像目录的变量:.lang="python"#DON'TCOPYthisline,itexistsjustforhighlightingpurposesSTATIC_PATHS=['images']来保存它。打开文章并添加图片如下:.lang="markdown"#DON'TCOPYthisline,itexistsjustforhighlightingpurposes![Writehereagooddescriptionforpeoplewhocan'tseetheimage]({filename}/images/IMAGE_NAME.jpg)您可以随时通过在终端中按CTRL+C来中断服务器。但是你应该重新启动它并检查图片是否正确。你还记得怎么做吗?(venv)$makehtml&&makeserve代码完成前的最后一步:您应该确保任何人都可以使用ATOM或RSS提要阅读您的文章。找到pelicanconf.py文件,该文件是您配置系统的地方,并编辑有关RSS提要生成的部分:.lang="python"#不要复制这一行,它的存在只是为了突出显示目的全部。atom.xml'FEED_ALL_RSS='feeds/all.rss.xml'AUTHOR_FEED_RSS='feeds/%s.rss.xml'RSS_FEED_SUMMARY_ONLY=False全部保存以便您可以将代码上传到Github。您可以通过添加所有文件、使用消息(“首次提交”)提交它并使用gitpush来完成此操作。系统将要求您提供Github登录名和密码。$gitadd-A&&gitcommit-a-m'firstcommit'&&gitpush--all还有……记得一开始,我告诉过你如何防止Pelican生成的静态文件输出master分支。现在是时候生成它们了:$makegithub系统将再次询问您的Github登录名和密码。好吧!您的新博客应在https://YOUR_USERNAME.github.io上创建。如果您在此过程中的任何一步遇到错误,请重新阅读本手册,尝试看看是否可以找到错误发生的部分,因为这是调试的第一步。有时甚至像Python中的拼写错误或错误缩进这样简单的事情也会给我们带来麻烦。在网上或在您的社区中大声疾呼并寻求帮助。关于如何使用Markdown写文章,可以阅读DaringFireballMarkdown指南。对于其他主题,我建议您访问PelicanThemes。这篇文章改编自AdrienLeger的Github托管的Pelican博客,使用Bottstrap3主题。