[drupal-docs] Dead links in documentation

[Kieran Lal]

On Sep 24, 2005, at 5:00 AM, Kobus Myburgh wrote:

>> And FWIW, I don't mind doing boring, remedial tasks like clicking  
>> on all the
>> module pages and changing the links by hand. :P Though if it were  
>> possible to
>> get db dumps of these pages or something similar, then I could try  
>> and script
>> this and it would go much faster.
>>
>
> I am not sure that scripting this would save much time for the  
> amount of pages we do have, would it? It would be handy in the  
> future though, for when the handbook expanded. We don't have that  
> many modules at the moment (unless I am sorely mistaken...).

Angie and you should both be focused on scripting.  In particular you  
can export all the pages in XML format right now.  There are around  
70 modules with administration help documentation and we should be  
working to have all of contributions have administration help pages.

http://drupal.org/book/export/docbook/289

That's the existing output format.  We need someone to grab the first  
block.   We need a script to check if the <a> element has a relative  
or absolute path associate with it.    If anyone has some handy php  
XML parsing skills this would be extremely valuable to the docs team  
right now.

For every relative a tag, create a variable, and then create an array  
at the end of the document which maps that variable back to the  
path.  If you do in PHP as a simple Drupal module that will be a HUGE  
amount of progress.

Kieran

<title>Aggregator: syndicating content</title>

<literallayout>
<p>The news aggregator is a powerful on-site RSS syndicator/news  
reader that can gather fresh content from news sites and weblogs  
around the web.</p>
<p>Users can view the latest news chronologically in the <a  
href="aggregator">main news aggregator display</a> or by <a  
href="aggregator/sources">source</a>. Administrators can add, edit  
and delete feeds and choose how often to check for newly updated news  
for each individual feed. Administrators can also tag individual  
feeds with categories, offering selective grouping of some feeds into  
separate displays. Listings of the latest news for individual sources  
or categorized sources can be enabled as blocks for display in the  
sidebar through the <a href="admin/block">block administration page</ 
a>. The news aggregator requires cron to check for the latest news  
from the sites to which you have subscribed. Drupal also provides a  
<a href="aggregator/opml">machine-readable OPML file</a> of all of  
your subscribed feeds.</p>
<p>You can</p>
<ul>
<li>administer your list of news feeds <a href="admin/ 
aggregator">administer &gt;&gt;  aggregator</a>.</li>
<li>add a new feed <a href="admin/aggregator/add/feed">administer  
&gt;&gt; aggregator &gt;&gt; add feed</a>.</li>
<li>add a new category <a href="admin/aggregator/add/ 
category">administer &gt;&gt; aggregator &gt;&gt; add category  </ 
a>.</li>
<li>configure global settings for the news aggregator <a href="admin/ 
settings/aggregator">administer &gt;&gt; settings &gt;&gt;  
aggregator</a>.</li>
<li>control access to the aggregator module through access  
permissions<br />
  <a href = "admin/access">administer &gt;&gt; access control  
&gt;&gt; permissions</a>.</li>
<li>set permissions to access new feeds for user roles such as  
anonymous users at <a href="admin/access">administer &gt;&gt; access  
control</a>.</li>
<li>view the <a href="aggregator">aggregator page</a>.</li>
</ul>
</literallayout>


>
> Kobus
>
>
> --
> [ drupal-docs | http://lists.drupal.org/listinfo/drupal-docs ]
>
>