layout | title | descr | image | author_twitter | author | categories | published | |
---|---|---|---|---|---|---|---|---|
help |
Getting Started |
A brief introduction on how to use Prose, what it can do for you and what not. |
_mql |
Michael Aufreiter |
|
true |
This little guide walks you through the process of using Prose to manage your website.
We've created a simple template that you can use as a starting point, Prose Bootrap. All you have to do is creating a fork of the repository and give it a suitable new name. Please follow the steps described on the Bootstrap homepage. If you are already maintaining a Jekyll page you can skip this step.
Navigate to Prose.io. Now you can sign in to Github by using OAuth.
Here's the landing page, it gives you all the repositories you have access to. If a Jekyll site has multiple branches, you are prompted to select your desired branch, otherwise you jump into the repo directly. We're going to pick our fresh bootstraped site here.
Once you have selected a repository, you can browse your posts and sub-folders in a traditional file-browser-ish manner. You can create new files as well, which immediately opens an empty document for you, which you can save after populating it with some text.
Once the file has been loaded, all you have to do is pointing your cursor to the text and start typing. We're providing basic syntax highlighting for Markdown to assist you during the writing process.
You can instantly preview your writing by either clicking the preview icon at the document menu bar, or ctrl+shift+right
to toggle it.
If you don't write on a daily basis (like me) you might have difficulties to remember the Markdown syntax so we also included a cheatsheet that you can use for reference. You reach it by pressing ctrl+shift+left
.
Once you are ready, you can easily publish your article, which lets it show up on the actual webpage/blog. Try it.
Take full control about your post, and edit Metadata aka the YAML frontmatter. No limitations.
The editor not only supports Jekyll websites but can be used to edit any github repository (respectively any contained text file). You can use it to edit server.js
of your Node.js application for instance.
However, if you navigate to a Jekyll repository, the editor is smart enough to expose everything below _posts
and provide a the metadata editor along with the markdown preview panel.
Prose is also suitable as a full-featured writing environment, covering authoring and sharing articles. That's how you can do it:
- Create a new github repository. And call it...
documents
. - Open the editor and create
hello-world.md
. - Save it.
- Share it (we support deep linking to the rendered version)
Prose is similiar to iAWriter as it is also using a minimal interface for editing Markdown, but it's web-based and uses Github for storing your text so your writings are more than save and Github keeps a history of every saved version. So Prose can potentially be seen as a whole new way of sharing documents online, while utilizing the usual suspects Markdown and Github. Oh and it's free and open source.