Perlite安装完全手册从零开始部署你的笔记网站【免费下载链接】PerliteA web-based markdown viewer optimized for Obsidian项目地址: https://gitcode.com/GitHub_Trending/pe/PerlitePerlite是一款专为Obsidian优化的网页版Markdown查看器让你能够轻松将Obsidian笔记库转换为在线网站。本指南将带你完成从环境准备到网站部署的全过程即使是技术新手也能快速上手。 准备工作安装必备工具在开始Perlite安装前请确保你的系统已安装以下工具Git用于克隆项目代码库Docker和Docker Compose提供容器化部署环境ComposerPHP依赖管理工具非Docker部署需要你可以通过系统包管理器或官方网站获取这些工具。以Ubuntu为例sudo apt update sudo apt install git docker.io docker-compose 快速部署方案Docker一键安装Docker是推荐的Perlite部署方式无需复杂配置即可快速启动服务。1. 克隆项目代码git clone https://gitcode.com/GitHub_Trending/pe/Perlite cd Perlite2. 启动Docker容器项目提供了三种docker-compose配置文件适用于不同场景docker-compose.yml生产环境配置docker-compose-dev.yml开发环境配置docker-compose-test.yml测试环境配置使用生产环境配置启动服务docker-compose up -d3. 访问Perlite网站打开浏览器访问http://localhost:8080你将看到Perlite的主界面⚙️ 手动部署步骤适合开发者如果你需要自定义配置或进行二次开发可以选择手动部署方式。1. 克隆代码并安装依赖git clone https://gitcode.com/GitHub_Trending/pe/Perlite cd Perlite/perlite composer install2. 配置Web服务器将Web服务器根目录指向perlite文件夹并确保启用PHP支持。以Nginx为例添加以下配置server { listen 80; server_name perlite.example.com; root /path/to/Perlite/perlite; index index.php; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } }3. 修改配置文件编辑perlite/settings.php文件根据需要调整网站设置笔记库路径主题设置安全选项功能开关 配置与个性化Perlite提供了丰富的配置选项让你可以打造专属的笔记网站。元数据配置通过perlite/Demo/metadata.json文件你可以定义笔记的元数据信息。在Obsidian中安装Metadata Extractor插件后可以通过设置界面指定元数据保存路径知识图谱设置Perlite支持Obsidian风格的知识图谱可视化你可以在设置中调整图谱显示参数节点大小连线粗细布局算法显示标签主题切换Perlite支持Obsidian的明暗主题你可以在网站右上角切换主题模式或在settings.php中设置默认主题。 使用指南添加你的笔记将你的Obsidian笔记文件夹复制到perlite/Demo/Demo Documents目录重新启动Perlite服务在网站左侧导航栏浏览你的笔记使用右上角搜索框查找特定内容❓ 常见问题解决无法访问网站检查Docker容器是否正常运行docker-compose ps确认端口是否被占用netstat -tulpn | grep 8080查看容器日志docker-compose logs笔记无法显示检查笔记文件权限确认笔记路径配置正确验证文件格式是否为Markdown 完成安装恭喜你已成功部署Perlite笔记网站。现在你可以通过网页浏览器随时随地访问你的Obsidian笔记享受知识管理的便利。如需了解更多高级功能和配置选项请参考项目中的README.md文件。【免费下载链接】PerliteA web-based markdown viewer optimized for Obsidian项目地址: https://gitcode.com/GitHub_Trending/pe/Perlite创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考