家庭日记

一个用于捕捉记忆、故事、照片、想法、笑话和任何其他想要记住的东西的家用迷你日志网站

• 的
• 故事
• 照片
• 想法
• 笑话
• 视频
• 以及您想要记住的其他任何东西

我有一个旧的WordPress博客，我已经将其转换为markdown文件，并需要一个查看帖子的方式。我在寻找一个自托管的简单东西。我的设计要求包括

• 移动友好，并且易于从移动设备发布
• 需要看起来和感觉像移动应用
• 需要全部是静态文件，或者尽可能接近
• 需要基于markdown
• 需要有一个合理的目录结构
• 由于这是自托管的，所以不需要认证或社交认证
• 不需要数据库
• 不需要JavaScript框架
• 最小依赖
• 不需要通过UI编辑帖子
• 不需要通过UI删除帖子
• 能够重新生成所有HTML文件
• 能够使用文本编辑器添加新帖子

什么在起作用

• GitHub风格的markdown格式
• 索引页面
• 浅色/深色模式
• 新帖子页面
• 帖子页面
• 渐进式Web应用（PWA）支持（需要https）
• PWA作为分享目标
• 重新构建静态HTML文件（《http://your.server/all》）
• 响应式设计
• 站点初始化
• 将谷歌动态照片分割成静态照片和视频
• 除了新条目提交之外的所有静态文件
• 标签页面
• 视频上传

未来增强

• ¯\_(ツ)\_/¯

安装

pip install home-journal --user

使用

请决定您想要放置网站文件的目录。（例如：/home/user/home_journal）

home-journal --init --site-directory /home/user/home_journal

每次使用带有 --init 标志运行 home-journal 时，它都会从源树复制 css、js 和图标到网站中。如果这些文件在网站目录中已被自定义，那么在再次使用 --init 标志时，这些更改将被覆盖。

在稳定版本可用之前，css 和 js 文件可能会更改，因此需要使用 --init 标志运行。欢迎将 css 和 js 文件的改进作为对仓库的 pull request。

帮助

usage: home-journal [-h] [-i] [-l {debug,info,warning,error,critical}] [-f LOG_FILE] [-p PORT] -s SITE_DIRECTORY [-t TAGS]

options:
  -h, --help            show this help message and exit
  -i, --init            Initialize the site with css, js, and icons
  -l {debug,info,warning,error,critical}, --log_level {debug,info,warning,error,critical}
                        Log level
  -f LOG_FILE, --log_file LOG_FILE
                        Log file
  -p PORT, --port PORT  Port to run the server on
  -s SITE_DIRECTORY, --site_directory SITE_DIRECTORY
                        Path to the site directory
  -t TAGS, --tags TAGS  A list of tags for new posts

在容器中

尽管目前没有可用的容器，但在仓库中有一个示例 Container 文件。

容器需要 python、ffmpeg 和 libmagic。

以 fedora 为例的示例

FROM registry.fedoraproject.org/fedora-minimal:38

RUN dnf5 install -y https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-38.noarch.rpm && \
    dnf5 install -y \
        python3 \
        python3-pip \
        ffmpeg && \
    dnf5 clean all -y

RUN pip install --root-user-action=ignore \
        home-journal==0.0.7

使用

podman build  -f Containerfile --tag home-journal

运行

podman run --volume /home/user/site:/mnt/site --publish 9000:8000 home-journal \
    home-journal --log_file /mnt/site/hj.log \
        --log_level debug \
        --site_directory /mnt/site \
        --tags family,friends,food,home,travel \
        --init

其中 /home/user/site 是您想要放置网站文件和日志文件的目录。

请参阅仓库根目录中的个别文件以获取最新的示例。

感谢

• 时尚现代简洁的 CSS https://www.beercss.com/
• Markdown 到 HTML，GitHub 风格 https://github.com/theacodes/cmarkgfm
• GitHub 风格 markdown/html CSS https://github.com/sindresorhus/github-markdown-css
• 便捷的前置文件提取器 https://github.com/eyeseast/python-frontmatter
• 轻松将 WordPress xml 转换为 md https://github.com/lonekorean/wordpress-export-to-markdown
• 示例照片 https://unsplash.com/