Setting up blog & wiki to track development

Most project on the web use blogs & wiki so that developers can talk about the progress that is being done with their project.

For FlickRibbon we used Wordpress blog and MediaWiki

Here are some tips to change the blog and the wiki to match your project

Wordpress Plugins

  • Sociable is a plugin which adds social media buttons to your posts.
  • Search Plugin that searches both posts & pages.
  • All-in-one SEO optimizes your Wordpress blog for Search Engines.
  • cforms  is a plugin for Wordpress, offering convenient deployment of multiple contact forms throughout your blog or even on the same page.
  • Page Mash is a plugin that customises the order of your blog pages that are listed in and managed in the parent structure
  • WPCandy Plugins-we-use
  • Wordpress Iphone plugin

WP-Syntax Plugin

WP-Syntax is a wordpress plugin that allows you to highlight lines in your blog. It supports many programming languages and also has line numbers. Screenshot.

Google Search Plugin

Google search plugin replaces the wiki search plugins. Easy to use follow these steps so you can integrate the search with blog. You will need to create a google custom search, the service is free and easy.

Google Analytics

  • Blog
    1. Download & add analytics plugin to Wordpress
    2. Setup analytics from Google Analytics
    3. Copy the UA code from your google analytics to the analytics plugin configuration page
  • Wiki: Just copy the tracker code into the main page of the just before the </body> tag.

Installing & Editing Wiki Skin

  • Installing
    • Download wiki skins from various websites. We used Clean
    • Extract it into to desktop, and you will find a folder called skins
    • Use a ftp client and upload all the files in the folder skins to the your wiki server folder skins. fireftp (ftp client for firefox)
    • Open your local configuration file LocalSettings.php, and then find:
$wgDefaultSkin = 'monobook';

and change it to

$wgDefaultSkin = 'clean';
  • Editing
    • You can edit the css file of the skin which is located in the skin’s folder
    • Advance users: You can also edit the skin’s php file but only if you know what you are doing

Getting MediaWiki and Wordpress to play nice

FlickRibbon Code uses an installation of MediaWiki inside a Wordpress directory. Our /docs directory holds our wiki. To be able to use pretty URLs for both frameworks, we had to put a pretty funky .htaccess file in the Wordpress directory.

Note: Although the wiki appears to be in a folder named “docs”, it is actually named “docswiki” on the server.

# BEGIN MediaWiki
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^docs/(images|skins|fckeditor)/ - [PT,L,QSA]
RewriteRule ^docs/(.*)$ docswiki/index.php?title=$1 [PT,L,QSA]
RewriteRule ^docs/*$ docs/ [PT,L,QSA]
RewriteRule ^docs/(.*:.*)$ docswiki/index.php?title=$1 [PT,L,QSA]
RewriteRule ^docs/(.+)$ docswiki/index.php?title=$1 [PT,L,QSA]
# END MediaWiki
 
# BEGIN WordPress
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress
 
# Begin basic URL checker
Header append Vary host
RewriteCond %{HTTP_HOST} !^code.flickribbon\.com$ [NC]
RewriteRule ^(.*)$ http://code.flickribbon.com/$1 [R=301,L]
Permalink · Written on: 12-30-08 · No Comments »

Leave a Reply