Personal blogs
Committers with personal blogs are encouraged to add their feed to planet.apache.org for aggregation. To get your personal blog listed and aggregated, check out the planet module from our SVN repo and edit the config.ini. See the README and FAQ files for details.
svn co https://svn.apache.org/repos/asf/planet/
Project blogs
An installation of Roller exists at blogs.apache.org for the use of ASF Projects. Any project that wants a blog should have a PMC member email infra or create ajira issue.
Public Preview
For those that would like an easy way to post previews of drafts for lazy consensus or voting, a script has been setup to allow the preview url that Roller generates to be shared publicly.
A typical process is to create the blog post, set it up to publish in 3-4 days via the "Advanced Settings", then post the modified preview URL to your dev@ list with the anticipated publish date for lazy consensus.
Author instructions
Once a blog post has been saved at least once, Roller will give you a "Full Preview" button. Click this button and copy the resulting URL. This URL will look like follows:
https://blogs.apache.org/roller-ui/authoring/preview/test/?previewEntry=testing
Clicking on this URL will require you to log in and have permissions for the specific blog. For projects that are setup to allow public preview (see below), the following URL will be publicly viewable:
https://blogs.apache.org/preview/test/?previewEntry=testing
Note the "/roller-ui/authoring" section of the URL has been removed. This can be done by hand or via a clever bookmark in your browser that uses this text as the link:
javascript:window.location=window.location.toString().replace(/roller-ui.authoring./,"");
Clicking that bookmark while staring at the Roller preview page should automatically munge the URL and take you to the public preview page.
Admin instructions
By default entries for a given project are not viewable with the preview script. An admin of the project must log into Roller and add the "preview" user to the blog with Limited access.
- Log into blogs.apache.org
- Browse to the main page where new entries can be created
- Click "Preferences", then "Members", then "Invite new member" which is located on the far right
- Type "preview" into the Username textbox
- Select "preview (gmcdonald@apache.org)" from the list
- Check the "Limited" radio button
- Click the "Send invitation" submit button
- Done