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 http://news.bbc.co.uk/rss/newsonline_uk_edition/front_page/rss091.xml – 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:

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 http://mkdoc.com/help/howtos/.headlines.rss listing all the most recent howto documents, http://mkdoc.com/news/.headlines.rss listing all the latest news documents and http://mkdoc.com/.headlines.rss listing all the latest documents from the entire site.

Document Links

Email Newsletters
Introducing the powerful new email newsletter feature of MKDoc-1.6. The newsletter integrates seamlessly with MKDoc to bring relevant links to visitor's inboxes.
http://mkdoc.com/help/howtos/newsletters/
News Aggregators
Aggregators collect RSS newsfeeds from a variety of sources and summarise them for users.
http://dmoz.org/Reference/Libraries/Library_and_Information_Science/Technical_Services/Cataloguing/Metadata/RDF/Applications/RSS/News_Readers/
Blogs
An article describing weblogs (blogs)
http://www.blogbasics.com/blog-tutorial-1-1.php
BBC News
A news organisation based in the UK
http://news.bbc.co.uk/
This document was last modified on 2004-07-23 14:22:47.
MKDoc Ltd., 31 Psalter Lane, Sheffield, S11 8YL, UK.
Copyright © 2001-2005 MKDoc Ltd.