View on GitHub

Justwriting

Super Simple Markdown Blog Engine

Download this project as a .zip file Download this project as a tar.gz file

JustWriting

Introduction

Justwriting is a simple blog platform. You just need writing content with Markdown format, upload the .md file to website, then it will show .md files as posts on your website.

It can synchronize files to the server by Dropbox.

So don't care about lost files while the server damaged, as all files can be store on your local devices.

If share the folder in Dropbox with others, then all members can add, edit the postes.

Of cause, if you have problem to install Dropbox on servers, it also can upload files by FTP, SVN or git, any methods you can.

Oneline Demo

If you have any question, click here to tell me.

中文版使用说明移步这里

Requirements

Features

Installation

  1. Setting blog parameter, update 'settings.php'
  2. Upload codes to php space
  3. Upload Markdown files to folder 'posts'
  4. Open website, just so...

Web Server Configuration

Write Articles

Head information

Put the head information at the beginning of the .md file.

Date: 2014-08-09
Title: Post tilte
Intro: Post abstract
Tags: Tags
Status: public

Contents

The status also can be define as draft, then this file will not appeared on the website.

It also support Jekyll head information.

Add Posts

As Justwriting will convert any .md file in the posts folder to post, so you just need upload .md file to the servers through any ways. Here list some methods:

1. Synic with Dropbox Automatically

If running Justwriting on VPS, suggest to update post through Dropbox. Installation Process

2. Manually Update from Dropbox

For virtual host user, it may not able to install Dropbox client, JustWritting provide a function to manually pull files from Dropbox.

  1. Create App
  2. Generated access token
  3. Configure params in settings.php:

      $blog_config['dropbox']['key'],
      $blog_config['dropbox']['secret'],
      $blog_config['dropbox']['access_token']
    
  4. access http://your_justwriting_site/sync/dropbox/download for syncing posts

3. Through Api

Justwriting supports post through Api.

If use Api, it need true on the option in settings.php, and set the Api Key in it.

Click here to check the Api documents

Who are using

Contributors

License

Please see the file called LICENSE.