Writing and Editing Content

Pages, Posts, Meetings

Pages get linked in the menu and are generally enduring. Posts are time relevant announcements and updates. Meetings are meeting announcements and are archived with their games played.

The published button determines whether the page will get published in the live site. On the admin site unpublished pages will display in an alternative color.

Create a New Resource

From Admin select from the actions on the right side.

Pages

Pages appear in the menu according to their menuitem value. Pages with a menuitem value of 0 do not appear in the menu, but can still be linked from another page. The numbers do not need to be sequential, it is recommended to leave gaps to facilitate re-ordering. Having two pages with the same number won’t break anything, but their relative order won’t be predictable.

Posts

Posts have a field for current_until, which controls when they will drop off the front page. The front page also previews everything up to the first ***.

Meetings

A maintenance job will run every Saturday evening that will generate upcoming meetings from the template as needed. It will be possible to manually add a meeting from Admin as well, if this is ever needed. Meetings can be updated from Admin, so special events, alternate meeting locations etc can be added.

Markdown

Content can be written in HTML or Markdown. Here are some resources for markdown ITSFOSS Markdown Guide, A Cheat Sheet, Another Cheat Sheet. You can also use liquid templating in pages, Liquid is meant to be user editable.

Some pages contain raw HTML or use Ruby Templates instead of Liquid, HTML should be left alone, and the pages with Ruby Templates do not permit editing.

Note that while several options exist to create a horizontal rule on a page from Markdown, this site uses *** to indicate the end of the excerpt that is displayed on the home page.

Linking Things

The files management shows the embed code for uploaded items. If you need to link to another page, embed codes are used. You can find the embed code for a page from the listing for the resource type in Admin.

The Meetings Template

Maintenance copies this file when generating meetings. If you change this file and want to apply to meetings which have already been created, for meetings this month and forward you can set expires in the past. Publish Changes runs maintenance before building the live/public site, which will delete expired items and then re-create the missing meetings.

Removing Content

The current_until field in Posts only controls whether the post should be included on the home page, and be grouped in Current Posts on the Posts page. Posts will remain permanently in the Archived Posts.

Setting a resource to unpublished will not delete it, but it will no longer appear on the live site, and when previewed on the admin site it will be in a highlight color. If a meeting is cancelled, it should be unpublished and the expires set to the end of month of the meeting date, if it is deleted before then maintenance will re-create it.

Setting expires will tell the maintenance job to delete the file when it runs after that date. Setting this in the past will delete it the next time maintenance runs.