helpful-site 0.1.0

这是什么？

有用站点是一个静态站点生成器，它写在 Python-Markdown， Jinja2和 Crammit。它旨在提供 从标记和缩小建立网页的友好界面 css和js文件。您可以在这里查看示例页面的呈现 =>；http://helpfulsheep.com/toys/helpful-site/

特别是，有帮助的网站为您提供了：

• 岗位类别
• 提供帖子列表的主页和分类页
• 主页上的文章分页
• 上一篇文章和下一篇文章链接
• 使用<!--more-->关键字标记摘录的能力
• 支持每页属性，如描述、ogimage、样式 和脚本
• 代码块的语法突出显示
• 来自Ghost
的漂亮的casper主题
• 友好的config.yaml文件
柔性模板系统
• 静态Web服务器在本地试用您的网站

它是如何工作的？

该项目提供了许多./manage.py命令，这些命令使用 从src目录中生成静态站点的文件 目录。

要创建新页面，请运行

./manage.py new

将内容添加到页面后，运行

./manage.py build

生成HTML文件。如果您计划从 子目录，例如http://www.example.com/blog/，您应该更新 config.yaml文件并运行

./manage.py build --prod

要更新css和js文件，您应该运行

./manage.py mini

您也可以运行

./manage.py reset

删除整个dist文件夹并

./manage.py reset --all

删除src文件夹。您可以运行

./manage.py runserver

要启动本地服务器，最后但并非最不重要，

./manage.py update

缩小和构建文件。

弄脏手

• CD到舒适的位置
• git克隆git@github.com:g4b1nagy/help-site.git
• CD帮助站点/
• virtualenv.venv
• source.venv/bin/激活
• pip安装-r config/requirements.txt
• /manage.py更新
• /manage.py运行服务器
• 将浏览器指向 http://localhost:3000/

在此基础上构建站点应该是自定义 配置目录中的文件，即config.yaml和模板文件以及 将您自己的css和js文件添加到src目录。就媒体而言 没有推荐的策略，但是你可以存储你的文件 在每个帖子的目录中，使用相对链接指向它们。 这将提供最大的灵活性，同时也保持您的 posts atomic-仅限于一个目录。

已知问题

谷歌Chrome似乎不时地在 正在加载页面。根据this post， 这似乎是由于在css文件中使用rem单元造成的。

如果你做一些有趣的事情，比如在服务器上删除dist文件夹 在跑步，你可能会 socket.error: [Errno 98] Address already in use尝试时出错 重新启动。您需要手动查找服务器进程和 kill -9它。

是的，这是用python 2编写的。我很抱歉。不，没有测试。我 对此我更难过。

感觉大方吗？

贡献是非常受欢迎的，通常会得到 非常感谢！还有一个虚拟的拥抱。你可以随意处理任何问题 以后可能会给我一个请求。

如果你有更大的计划，请随时打电话给我 gabi@helpfulsheep.com。