The following is a draft “user guide” for the 1999.io blogging tool.
Overview
- http://blog.1999.io/2016/04/11/0003.html – Philosophy
- http://blog.1999.io/2016/04/11/0004.html – Technical overview
Initial server setup (describe as many server providers as possible)
- Amazon Web Services
- How to Set Up An Ubuntu Server on Amazon Web Services – available on the Amazon Kindle Store
- (http://blog.1999.io/2016/05/07/0020.html – AMI set up for 1999.io by Dave Winer)
- Cloud at Cost (http://clarkonium.net/2016/02/cloudatcost-setup-notes/ )
- Microsoft Azure (https://github.com/scripting/river5/wiki/Installing-on-Azure )
- Google Web Platform (https://groups.google.com/forum/?hl=en#!topic/river5/hsXAUdbyEOA, some info, more specific to installing River5)
- None (use Dave Winer installation at http://my.1999.io/ )
General installation https://github.com/scripting/1999-project/blob/master/docs/setup.md – includes instructions specific to Ubuntu installations
Creating/editing a post from the web app
- https://www.youtube.com/watch?v=PYZKUVJfuMI Creating and editing posts in 1999.io (Dave Winer)
- http://blog.1999.io/2016/04/11/0005.html Terminology
- https://www.youtube.com/watch?v=sbqv9SwlFrw Demo of inserting HTML text into 1999.io
- http://blog.1999.io/2016/05/02/0018.html Update on Insert HTML menu command
- http://my.1999.io/users/1999io/2016/04/14/0007.html – Adding small images to stories
- http://my.1999.io/users/1999io/2016/04/11/0002.html – Getting started
- Publishing options when you post (can make live when you click the post button, this also updates the RSS feed when you post, which may be incomplete). To not fully publish until you are ready, change option in the Misc menu to uncheck the “Automatically publish new posts?” checkbox. (See http://blog.1999.io/2016/04/22/0012.html)
- http://blog.1999.io/2016/05/08/0022.html – Adding a podcast sound file enclosure to a post
Config settings
- https://github.com/scripting/1999-project/blob/master/docs/setup.md#create-configjson – Creating config.json when installing
- Add links to all options where the user would add something to config.json or change something
Multple user support
- Default installation of 1999.io allows anyone with a Twitter account to create a blog on their server
- Whitelists can be used to allow 1999 server operators to restrict who can create accounts on a server (can be limited to just the server owner) (more info at https://github.com/scripting/1999-project/blob/master/docs/whitelist.md )
Customizing the home page
- http://blog.1999.io/2016/04/11/0006.html – Discusses editing the template, the menu bar, and the Settings menu/Pages panel for changing the look of the story pages/home page
- https://github.com/scripting/1999-project/blob/master/docs/homepage.md – Settings that can be included in config.json to customize the look of the editor on the home page
Editing the template for a 1999.io blog
- Use the 1999 web page, select Main menu, then Edit template menu item, a window will open with HTML text
- http://blog.1999.io/2016/04/11/0006.html – Discusses editing the template used to render story pages
- http://blog.1999.io/2016/05/09/0023.html – Glossary feature allows the user to specify strings to be added to the template
Setting up plugins
- https://github.com/scripting/1999-project/blob/master/docs/plugins.md – Explains how to set up plugins on your server, plugins support new editors, template editor is the first one
Using the template editor plugin
- http://blog.1999.io/2016/05/16/0024.html – Original instructions on using the template editor
- http://blog.1999.io/2016/05/26/0025.html – Update to template editor
Using the 1999.io Mac app with the 1999.io server
- http://blog.1999.io/2016/04/14/0008.html – Using the 1999 app for the Mac
- http://blog.1999.io/2016/04/21/0010.html – Using 1999.app with your server
Other topics
- Callbacks (scripts that can be called when a post is published) (https://github.com/scripting/1999-project/blob/master/docs/callbacks.md)
- Macros – text that can be included in the template to use data available in the pageTable Javascript object (https://github.com/scripting/1999-project/blob/master/docs/macros.md )
- Domains – How to map a domain to a 1999.io blog (https://github.com/scripting/1999-project/blob/master/docs/domains.md )
Overview of menus on the home page of the editor
Copying site files to another server (like Frank McPherson and Jack Baty)
Backing up your site
Migrating your site from one server to another
Other resources: