hjue/justwriting

Markdown博客系统

1.0.0 2015-01-20 07:25 UTC

This package is not auto-updated.

Last update: 2024-09-14 16:44:59 UTC


README

Build Status Latest Stable Version Total Downloads Latest Unstable Version License

简介

Justwriting 是一个简单的博客平台。你只需用 Markdown 写下文本,将 .md 文件上传到网站,它就会将 .md 文件作为帖子显示在你的网站上。

它可以通过 Dropbox 同步文件到服务器,所以当服务器损坏时,你不用担心文件丢失,因为所有文件都可以存储在您的本地设备上。

如果您将 Dropbox 文件夹与他人共享,所有成员都可以添加或编辑帖子。

当然,如果您在服务器上安装 Dropbox 有问题,它也可以通过 FTP、SVN 或 git 或其他您上传文件的方法上传文件。

SAE 上的在线演示

OpenShift 上的在线演示

如果您有任何问题,请随时 问我

中文版使用说明请参考这里

要求

  • PHP 5.3.6+

特性

  • 简单的博客平台
  • 无需在线 TOC 编辑器,您可以在任何设备上离线撰写帖子
  • 无需数据库
  • 使用 Markdown 编写
  • 支持代码高亮显示
  • 支持 LaTeX 数学公式
  • 支持 TOC
  • 多主题
  • 支持通过 Dropbox 更新
  • 支持通过 API 发帖
  • 支持 Jekyll 帖子文件

安装

  1. 在 'settings.php' 中设置博客设置
  2. 将代码上传到 PHP 空间
  3. 将您的 Markdown 文件上传到 'posts' 文件夹
  4. 打开网站,完成。

使用 Docker 部署

docker pull hjue/justwriting

JustWriting Docker 仓库

Web 服务器配置

JustWriting 主题

撰写文章

头部信息

将头部信息放在 .md 文件的开始处。

Date: 2014-12-31
Title: Post tilte
Intro: Post abstract
Tags: justwriting blog
Toc:yes
Status: public
Position: 1

Contents

也可以将 status 定义为 draft,这样该文件就不会显示在网站上。

Toc 可以控制是否显示目录,接受 yes 或 no。

它还支持 Jekyll 头部信息。

添加帖子

因为 Justwriting 会将 'posts' 文件夹中的任何 .md 文件转换为帖子,所以您只需通过任何方式将 .md 文件上传到服务器。以下列出了一些方法

1. 通过 Dropbox 客户端自动同步

如果您在 VPS 上运行 Justwriting,建议通过 Dropbox 更新帖子。安装过程

2. 通过 Dropbox webhook URL 同步

对于虚拟主机用户,可能无法安装 Dropbox 客户端,JustWritting 提供了一个手动从 Dropbox 拉取文件的功能。

  1. 创建 App
  • 生成访问令牌
  • 添加 Webhook URI http://<your_justwriting_site>/sync/dropbox/download

Dropbox Create App

  1. 在 settings.php 中配置参数
$blog_config['dropbox']['key'],
$blog_config['dropbox']['secret'],
$blog_config['dropbox']['access_token']

http://your_justwriting_site/sync/dropbox/download 是同步帖子的 URL

3. 通过 API

Justwriting 支持通过 API 发帖。

如果使用 API,需要在 settings.php 中的选项设置为 true,并设置 API 密钥。

点击此处查看 API 文档

谁使用 JustWriting?

贡献者

许可证

请参阅名为LICENSE的文件。