Using Luna is a three-step process: Write. Build. Deploy. View the a sample of the blog here: http://yangshun.github.io/luna/.
Note: You will have to install the Python package
dicttoxml in order to enable RSS for the blog. Simply install it by running:
pip install dicttoxml
Writing blog posts is easy. Simple add markdown files to the
./postsdirectory. Avoid file names containing
#and special symbols.
By convention, the Python build script extracts the first line of the markdown file as the title of the post. Please write your posts in this fashion:
My Awesome Blog Post == This marks the start of me using Luna to blog.
Luna is a SPA (Single-Page Application) and the url slug for each post will be the the title in lower case, with words concatenated by hyphens. For example, a post with the title My Awesome Blog Post will be identified by
To compile the site for uploading, run:
$ python3 build.py
This command will compile the markdown files in the
./postsdirectory into a JSON file called
Open this directory in a webserver to view the blog.
Write. Build. Deploy. Have fun!
A number of configuration options are available in
build.py. They should be pretty self-explanatory. Have a look at it and change the values where appropriate. More configurations to be added in future releases.
- Tay Yang Shun (https://www.github.com/yangshun)
Copyright (c) Luna 2013. Licensed under the MIT license.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.