Skip to content
A notebook application to have your notes always on hand.
JavaScript PHP Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
files
static
.htaccess
README.md
index.php
spmdwe-examples.md
spmdwe-markdown_styles.md
spmdwe-readme.md
template.php

README.md

Single-page Markdown Web Editor (spmdwe)

Copyleft rigon, February 2016

Homepage and demo:

Intro

This is a small "web application". It's based on a application called spmdwe, created by sdaau in 2012:

The application consists on one file. It can be installed on a PHP Web Server and can used to edit text files with live preview for Markdown syntax. With proper permissions on the server's directory, files can also be saved on the host (a backup of the previous version is also saved). There are two switches, one that disables saving and other that disables authentication.

It is based on four other open-source packages, which can be downloaded separately (see Installation below):

While the default .css style shown here is hardly impressive, do check out the list of some free markdown css styles, which can be used instead.

Features

Since this project is a fork from the original project spmdwe, it inherits the main features:

  • Editing Markdown files
  • Live editing, writing automatically updates the output
  • View and edit modes
  • Backup old versions of the file

In this version, these new features have been added:

  • Fresh and modern design and layout reorganization
  • Clear URLs, without the hassle of URL parameters
  • Edition side by side with the view
  • Ability to navigate through history
  • Ready for Mobile, with responsive layout that adapts automatically
  • File upload management, attached to each page
  • Publish mode for guest users
  • Website template editor and previewer
  • Page download in HTML, Markdown and ZIP
  • Option to make files read only
  • Application improvements

Download

There is the link to download:

Installation

Here are the steps needed to install this application, in the form of bash commands:

# mkdir spmdwe # if downloading manually, else:
# checkout from svn - creates `spmdwe` directory and files in it
wget https://github.com/rigon/notes/archive/master.zip
unzip master.zip
mv notes-master/ notes

sudo chown www-data:www-data notes/files  # on server, else cannot save files!

Configuration

To work properly it is required the ReWrite Module to be active in apache.

Then the next configuration should be used. This can be done via .htaccess file or on apache configuration:

RewriteEngine on

RewriteCond %{REQUEST_URI} !^/notes/static
RewriteCond %{REQUEST_URI} !^/notes/files/[^/]+/[^/]+\.[^/]+

RewriteRule ^([^/]*)$ index.php?file=$1 [L,QSA]


RewriteCond %{REQUEST_URI} !^/notes/static
RewriteCond %{REQUEST_URI} !^/notes/files/[^/]+/[^/]+\.[^/]+

RewriteRule .* "-" [F]

You have to change the directory /notes to the directory you've installed.

Usage

The application is pretty simple:

  • there is a view mode, which doesn't show an edit box, shows the html view
  • there is edit mode, which shows a live html preview, edit box right next to it, and shows Save and Save and View at the end
  • Both view and edit can be used as values for the mode query string argument (see source code for details)
  • Upon save, the old version is backed up, with a filename with appended unix timestamp; the new version is saved under the original filename - and the new version is displayed in view mode
  • Save will save the file and continue in editing mode and Save and View will save and change to view mode
  • A file is chosen by adding manually the filename in the URL, say http://example.com/notes/somefile.
  • If a requested file (somefile) doesn't exist, it should be created automatically, and edit mode displayed
  • Otherwise, without any other arguments, a file is loaded in view mode
  • If the application is called without any arguments whatsoever (say, http://example.com/notes/), then it loads home and goes into view mode.
  • If you are a guest user, you will see the published version and you cannot edit files.
You can’t perform that action at this time.