# Wren - README.md markdown=yes Wren is a web-based, static site, blog tool. It requires the user to create most of the features that would be automatically created in "normal" web publishing apps. For example, the homepage is not automatically generated. The index.html files that are located in the root directory and in sub-directories get created and updated like a regular article post. The same applies to archives and tag-related pages. It's a slower way to produce content, which may mean staying more focused and writing when having something important to create, instead of saving and commenting on every link encountered. But posts can be created and updated through a web browser on a desktop/laptop or on a mobile device. Wren has an API, which can be accessed with command prompt utilities or curl. I'll need to finish creating the command prompt utilities, and I need to enable the API to support "preview" when access has no authentication. Preview will return the formatted post, which could be saved on a local hard drive. For logging into a Wren site, it uses a no-password login mechanism. The author submits an email address, and the login activation link is emailed to the author. The app uses [MailGun](http://www.mailgun.com/). Text can be formatted using [Markdown](https://daringfireball.net/projects/markdown/) and HTML commands. Actually, Wren supports MultiMarkdown, which means being able to create tables, footnotes, definition lists, and more. No Textile support in Wren. That's a deviation from my other web publishing apps. Here's a test Wren site that uses posts that I created elsewhere in the past: * I'm also using Wren to store updates about my Dad's cancer treatment at: * For search, I will rely on using Google and/or DuckDuckGo. I need to add support for writing with the JavaScript editor that I have enabled with my other web publishing apps. To access the markup text version of a post, replace ".html" at the end of the URL with ".txt". Wren maintains a list of all links to posts in a file called links.json. Wren uses this file to create rss.xml, sitemap.xml, and mft.html. mft.html lists the most recent posts in an HTML file that uses [microformats](http://microformats.org/wiki/microformats2). Some [Indieweb users](https://indiewebcamp.com/) prefer to syndicate their content by marking up their HTML files with microformats. Parsers would read a user's homepage to create a feed to be read by someone else, instead of accessing a user's RSS feed. When logged into Wren through a web browser, the author enters the commands in the URL after the site's domain name. * /wren/create * /wren/update/file.html or /wren/update/2016/03/24/file.html * /wren/login * /wren/logout In the Wren YAML configuration file, the following directories need to be specified: * markup_storage /home/wren/markup session_id_storage /home/wren/sessionids versions_storage /versions Files: links_json_file /links.json rss_file /rss.xml Commands: todo: Custom formatting commands: br . fence . fence..