Posts

Overview

Blog posts can be created with the Post Composer or Open Live Writer. Posts are either Published or in Drafts, they are Categorized and can be Tagged. Categories are used to simulate multi-blog scenario and can be assigned to the Site Navigation.

Post Composer

The composer is consisted of three parts, Editor, Topbar and Sidebar.

Post Composer

Editor

The editor for writing posts is a WYSIWIG editor based on CKEditor 5.

Keyboard Shortcuts

It supports Markdown syntax as shortcuts and knowing these are very handy when you blog.

Shortcuts Description
# + space Use one or more # for headings (h1, h2 etc.)
> + space Quote
- + space Unordered list (ul)
`` Inline code
Select text, Ctrl + k Make text link
Shift + enter Soft break (br)
Drag & drop images Only png, jpg and gif files are supported

Images

The Media Gallery is integrated to the Editor. You can also drag & drop image files to the browser.

⚠️ If you upload images from Open Live Writer, for each image OLW will have two copies uploaded.

Topbar

The Topbar shows a list of buttons that allows you to Publish, Update, Save, Auto-save, Preview and Close the post.

Auto-save Draft

Your work is auto-saved after typing stops for a few seconds (default 10 sec). If you continue to type after a short break but before the threshold is reached it won’t carry out auto-save. When auto-save happens you will see a disabled text SAVED.

⚠️ It’s only for drafts. When you make changes to a published post, auto-save won’t save your work to prevent accidently showing your unfinished work to the public.

Save

Under certain conditions by design auto-save will not happen

  • When you make changes to the content of a post that is published (this is just discussed above)
  • When you make changes to elements on the sidebar or post title, not in the editor

In these circumstances, you have to click on the save button to save the content.

Publish / Update

Depending whether the post is published or a draft, you would see a Publish or Update button. The post title is the only thing that is required, when that is missing the button will be disabled.

Sidebar

The Sidbar contains post information such as post status, date etc.

Revert to draft

For quick changes to a published post, you just make your changes and hit Publish. But if you find yourself making lengthy changes, I recommend you Rever the post back to draft, so that autosave can help you save.

Post Date

You can choose any year, month and date, the time will just be the time you hit Publish. Currently there is no scheduling, if you set a future date it’ll just show up with that future date.

💥 Be careful to update a published post’s date, it may cause issues with search engines as the URL of a post has yyyy/mm as part of it.

Category

When you open the Composer to create a new post, the default category will be selected for you automatically. All posts must have a least one category. See Categories.

Tags

You can have zero to many tags. ⚠️ The tag selection comes from a dropdown, but if you enter a brand new tag just hit “tab” to delimit it.

Slug

Slug is the human friendly URL. The slug auto generates from Title when it first saves it, it’s good practice to make sure it’s a value you like.

💥 Be careful to update a published post’s slug, it will cause issues with search engines.

Exerpt

When you set the Display post in option to Excerpt on the blog settings, the blog will show an excerpt for each post instead of full body. Category and tag pages by default show excerpts. If you leave this field blank, the blog will calculate an excerpt from post body for you.

Open Live Writer

Fanray supports the MetaWeblog API and thus you can use clients such as the Open Live Writer.

Get started

  • First have the web app running either locally or from remote
  • Install and open OLW > Add blog account… > Other services > type in
    • Web address of your blog
    • User name
    • Password

The login credentials here are what you created on the blog setup page.

Usage Tips

Some usage tips and things to be aware when posting with OLW.

  1. The tags are comma-delimited in OLW (this is unlike the online Composer’s tag selector which is tab-delimited)
  2. Be aware when you upload an image, OLW sends two copies of it to the server. One thumb and one regular, the thumb image shows up in your post with a link to the regular image. Therefore you will see two images show up in your Media Gallery. Also, once you open the post up in Composer, CKEditor will remove the link from your thumb.

Note: I found that OLW does not always output correct HTML.

Open Live Writer

Categories

Categories are used to simulate a multi-blog scenario in which the user wants to write completely different topics but doesn’t want to maintain multi sites. The user can put posts to different categories and the categories can assigned to the Site Navigation .

All blog posts belong to one category, it automatically defaults to a Default Category which can updated but cannot be deleted, and you can also let any category be the Default Category. When you delete a category, all its posts will be automatically transferred under the Default one.

Tags

Tags are a more fine-grained way to classify your posts than categories. A post can have zero or more tags, this is unlike category in which a post has to at least have one category.

⚠️ Only tags with at least one published post will show up on the public facing site.

Deploy to Azure
Pages