Skip Navigation


Apache 2.2 mod_cache

Server Tuning

Petal i18n and I18NFool

HowTo Compile Apache 1.3 for MKDoc

Integrate Soupermail

Creating new document components

Translate MKDoc Templates

Checkout MKDoc via anon CVS

Configuring MKDoc::Apache_Cache

MySQL commands to make a user account an editor account

Using news headlines

Customisation with CSS

Hiding documents and creating private areas

Upgrade from 1.4 to 1.6

Discussion Board Moderation

Text Component Formatting

Site Administration

Email newsletters

Edit Templates in a Subversion Repository

Update the Metadata for all Documents

Import MS Word files into MKDoc

Sign up

If you sign up for an account on this web site you can customise elements of this site and subscribe to an email newsletter.

If you have an account on this web site you may login.

If you have an account on this site but have forgotten your user name and / or your password then you can request an account reminder email.

Using news headlines

Once you have a site with more than a handful of pages, a major problem is making-sure that people revisting the site can discover new content – New visitors can find what they need through search engines in combination with standard internal navigation devices such as inline-links, the sidebar and top menu navigation.

MKDoc has some clever features especially for users who just want to see the latest information:

Email Newsletters

When email newsletters are enabled, visitors with accounts can indicate their interests and be automatically sent relevant headlines daily, weekly or monthly – Allowing them to follow the site without constantly revisiting.

RSS Headlines

News aggregators can be configured to fetch the latest RSS headlines from any part of an MKDoc site and present this information as part of a users daily routine.

Headlines Components

MKDoc documents can themselves list headlines from a variety of sources; a common use is for the front page to consist entirely of all the latest documents added to the site in a news or blog format.

Headlines are individually customised for all logged-in visitors – Only documents that match the users interests are shown.

Adding headlines

To put headlines in any MKDoc document, simply create a headlines component and fill in the Base Headlines Path – This is the address of the section of the site you want to use to get your headlines.

For example to list the most recent documents from the entire site, enter /, to list all the most recent HowTo documents, enter /help/howtos/ or to list all the most recent news articles in the News section of a site, enter /news/ to get a list of headlines like so:

News articles on the MKDoc web-site

MKDoc-1.6.31 released
MKDoc 1.6.31 is the latest in the 'stable' branch of MKDoc, This is a feature release that adds new functionality, read the INSTALL.TXT file before upgrading from an earlier version.
2005-09-13 13:25:17
MKDoc-Text-Structured-0.83 Released
MKDoc::Text::Structured is the perl module behind the MKDoc Text component. This release adds extra functionality to support the new MKDoc Comment plugin.
2005-09-08 01:56:25
Petal-2.17 released
Petal is the XML templating engine developed for MKDoc. This is a minor bugfix release, there is no need to upgrade Petal for sites running MKDoc
2005-09-07 08:57:08

Importing RSS Headlines

RSS is a standard for syndicating news and links between web-sites. An RSS feed is just a list of document addresses with some extra metadata information – An example is a news organisation such as the BBC which regularly updates all their latest news headlines.

A quick search of the BBC News web-site shows that the URI for their news RSS is – So to embed these headlines in any MKDoc document, simply create an RSS Component and fill-in the URI field; save the page, wait a few minutes for the RSS to be fetched and see the result:

News from the BBC

The RSS feed was not found.

You can choose to have either a bulleted-list of linked-titles or a definition-list of titles and descriptions. Depending on the template, RSS lists may appear in a side-bar box instead of the body of the document.

Exporting RSS headlines

Every MKDoc page with child documents automatically has its own RSS feed that lists the most recent documents for that section of the site. This means that many people can access your latest documents in a variety of different ways through news aggregators, blogs and other MKDoc sites.

Figuring-out the location of any RSS feed is simple, simply take the URI of the section you want and add .headlines.rss onto the end.

Examples of MKDoc RSS feeds from this site are listing all the most recent howto documents, listing all the latest news documents and listing all the latest documents from the entire site.

<< | Up | >>

This document was last modified by Bruno Postle on 2004-07-23 14:22:47
MKDoc Ltd., 31 Psalter Lane, Sheffield, S11 8YL, UK.
Copyright © 2001-2005 MKDoc Ltd.