HTMLy
=====

HTMLy is an open source databaseless blogging platform prioritizing simplicity and speed.

Features:
---------

- Admin panel
- Markdown editor with live preview
- Categorization with tags (multi tags support)
- Static pages Eg. for contact page
- Meta canonical, description, and markup for SEO
- Pagination
- Author page
- Multi author support
- Social links
- Disqus Commenting System
- Google Analytics
- Built-in search
- Related posts
- Per post navigation (previous and next post)
- Body class for easy theming
- Breadcrumb
- Archive page (by year, year-month, or year-month-day)
- JSON API
- OPML
- RSS Feed
- Sitemap.xml
- Archive and tag cloud widget
- SEO friendly URL
- Teaser thumbnail for images and Youtube videos. 

Requirements
------------

HTMLy requires PHP 5.3 or greater.

Installations
-------------

Download the latest version, extract it, then upload the extracted files to your server. Make sure the installation folder is writeable by your server.

Configurations
--------------

Change `config.ini` inside `config` folder, and than create `YourUsername.ini` inside `config/users` folder, write down your password there.

````
password = YourPassword
````

You can login to admin panel at `www.example.com/login`.

Both Online or Offline
----------------------

In addition to using the built-in editor in the admin panel, you can also write it offline and then upload them into `content/username/blog` folder (the username must match with `YourUsername.ini` above). 

For static pages you can upload it to `content/static` folder.

File Naming Convention
----------------------

When you write a blog post and save it via the admin panel, HTMLy automatically create a .md file extension with the following name, example:

````
2014-01-31-12-56_tag1,tag2,tag3_databaseless-blogging-platform.md
````

Here's the explanation (separated by an underscore):

- `2014-01-31-12-56` is the published date. The date format is `yyyy-mm-dd-hh-mm`
- `tag1,tag2,tag3` is the tag, separated by comma
- `databaseless-blogging-platform` is the URL

For static pages, we use the following format:

````
about.md
````

That is means if `about` is the URL.

So if you write it offline then you must naming the .md file as above.

Content Title
-------------

If you write it offline, for the title of the post you need to add a title in the following format:

    <!--t Here is the post title t-->

	Paragraph 1

	Paragraph 2 etc.

So wrap the title with HTML comment with `t` for both side.

Demo
----

Visit the demo blog on [Danlogs](http://www.danlogs.com).

Credit
------

People who give references and inspiration for HTMLy:
* [Martin Angelov](http://tutorialzine.com)


Copyright / License
-------------------

For copyright notice please read [COPYRIGHT.txt](https://github.com/danpros/htmly/blob/master/COPYRIGHT.txt). HTMLy licensed under the GNU General Public License Version 2.0 (or later).