Obsidian Publish的开源替代品Perlite-编程知识

在这里插入图片描述

前几天就有网友跟我说，freenom 的免费域名不可用了，10 号的时候老苏进后台看了一下，还有一半的域名显示为 ACTIVE，似乎是以 2024年6月 为限。但到 11 号，老苏发现博客 (https://laosu.cf) 已经访问不了了，这时候再进 freenom 后台，所有域名的状态都已经全部变成 PENDING 了。

截至目前，freenom 尚未就回收免费域名的具体理由向公众作出官方解释，但可以肯定的是，不管什么原因，freenom 的免费域名以后肯定是用不了了

即日起，博客正式启用域名：https://laosu.tech

本文软件由朋友 Eduna 推荐；

什么是 Perlite ？

Perlite 是针对 Obsidian 优化的基于 Web 的 Markdown 查看器。可以在网络上显示您的黑曜石笔记，只需将整个 Obsidian Vault 或 Markdown 文件夹/文件结构放入您的 Web 目录中即可。该页面会自行构建。

软件特点：

自动构建，基于您的文件夹（保险库）结构
支持 Obsidian 主题
完全响应式
无需手动解析或转换
完整的交互式图表
支持 LaTeX 和 Mermaid
链接至 Obsidian Vault
搜索功能
支持 Obsidian 标签、链接、图像和预览
暗黑模式和明亮模式

简单的说，Perlite 就是付费的 Obsidian Publish 的开源替代品

在这里插入图片描述

安装

在群晖上以 Docker 方式安装。

如果在注册表中搜索 perlite ，选择第一个 sec77/perlite，版本选择 latest。

本文写作时， latest 版本对应为 1.5.8；

在这里插入图片描述

因为这个镜像是基于 php:fpm 构建的，因此还需要有 web 服务器的配合，所以采用 docker-compose 安装会更简单

docker-compose.yml

将下面的内容保存为 docker-compose.yml 文件

version: "3.9"services:perlite:image: sec77/perlite:latestcontainer_name: perliterestart: unless-stoppedenvironment:- NOTES_PATH=Demo- HIDE_FOLDERS=docs,private,trash- LINE_BREAKS=true- ABSOLUTE_PATHES=false- ALLOWED_FILE_LINK_TYPES=pdf,mp4- DISABLE_POP_HOVER=false- SHOW_TOC=true- SHOW_LOCAL_GRAPH=true- HOME_FILE=README- FONT_SIZE=15- HTML_SAFE_MODE=true- TEMP_PATH=/tmp- SITE_TITLE=Demo- SITE_TYPE=article- SITE_URL=- SITE_IMAGE=- SITE_DESC=- SITE_NAME=- SITE_TWITTER=- SITE_LOGO=- SITE_HOMEPAGE=- SITE_GITHUB=volumes:- ./data:/var/www/perlite/Demo:roweb:image: nginx:latestcontainer_name: perlite_webrestart: unless-stoppedports:- 4980:80volumes:- ./nginx.conf:/etc/nginx/conf.d/default.conf:rovolumes_from: - perlite       depends_on:- perlite

容器 perlite 的主要环境变量：

NOTES_PATH：设置 NOTES_PATH=Demo，用于定义您笔记的 Obsidian 保险库文件夹（根路径/文件夹），该文件夹必须是 Perlite/perlite 的子文件夹。
HIDE_FOLDERS：设置 HIDE_FOLDERS=docs,private,trash，以排除要在左侧导航面板中可见的（数组中的）文件夹。以 “.”（点）开头的文件夹和文件默认排除。
LINE_BREAKS：设置 LINE_BREAKS=true，如果您想使用 “简单” 的换行符而不是 Markdown 换行符。
ABSOLUTE_PATHES：设置 ABSOLUTE_PATHES=true，以使用绝对文件路径而不是相对路径进行内部链接。
ALLOWED_FILE_LINK_TYPES：设置 ALLOWED_FILE_LINK_TYPES=pdf,doc，以允许将（数组中的）文件类型显示为笔记中的直接链接。
DISABLE_POP_HOVER：设置 ·DISABLE_POP_HOVER=true，以设置悬停在内部链接上时的默认弹出行为。
SHOW_TOC：设置 SHOW_TOC=true，如果您想默认显示目录（大纲）。
SHOW_LOCAL_GRAPH：设置 SHOW_LOCAL_GRAPH=true，如果您想默认显示图形视图。
HOME_FILE：设置 HOME_FILE=README，如果您想将主页设置为保险库根目录中的 README.md。这必须是一个 .md 文件，所以您只需要定义文件名（不包括扩展名）。
FONT_SIZE：设置 FONT_SIZE=15，以设置默认的字体大小。
HTML_SAFE_MODE：设置 HTML_SAFE_MODE=false，以允许在您的 Markdown 中使用 HTML。
TEMP_PATH：设置 TEMP_PATH=/tmp，以定义图形临时文件的存储位置。
SITE_：站点及社交媒体设置，对应下图左上角位置。

在这里插入图片描述

更完整的介绍，请参考官方文档：https://github.com/secure-77/Perlite/wiki/03—Perlite-Settings#optional-perlite-settings

nginx.conf

将下面的内容保存为 nginx.conf 文件。因为 md 、json 等文件里面可能包含敏感信息，所以我们要阻止从网络上直接访问或者下载这些扩展名的文件，而只有 php 引擎需要访问此文件。

server {listen 80;server_name localhost;root /var/www/perlite;index index.php index.html index.htm;access_log /var/log/nginx/php-access.log;error_log /var/log/nginx/php-error.log;# PHP-FPM Configuration Nginxlocation ~ \.php$ {try_files $uri = 404;fastcgi_split_path_info ^(.+\.php)(/.+)$;fastcgi_pass perlite:9000;fastcgi_index index.php;include fastcgi_params;fastcgi_param REQUEST_URI $request_uri;fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;fastcgi_param PATH_INFO $fastcgi_path_info;}location ~ /\.ht {deny all;}location ~* ^/(.*)/.obsidian/appearance.json$ {allow all;}location ~* ^/(.*)/.obsidian/(.*)/theme.css$ {allow all;}location ~ \.(git|github|obsidian|trash) {deny all;}location ~ \.(md|json)$ {deny all;}
}

然后执行下面的命令

# 新建文件夹 perlite 和 子目录
mkdir -p /volume1/docker/perlite/data# 进入 perlite 目录
cd /volume1/docker/perlite# 将 docker-compose.yml 和 nginx.conf 放入当前目录# 一键启动
docker-compose up -d

在这里插入图片描述