forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dave Brondsema <d...@brondsema.net>
Subject Re: merging separate sets of generated docs, default tabs
Date Fri, 01 Apr 2005 03:06:22 GMT
David Crossley wrote:
> Dave Brondsema wrote:
>
>>Ok.  What about href="/docs"?  I think because it is a 'href' it would
>>keep it from failing the build, and it would still be relative.
>
>
> That should work. I woder why we didn't think of that before.
> Maybe it was all getting confused with the separate 0.6 docs.
> Dunno. Lets try it.
>
>

Done.  I had forgotten about this.

>>Regarding the 2nd change: I removed the project-related tabs from
>>docs-author, so that the docs would be completely independent.  This
>>lets a user have a local copy of the docs with no broken links; it is
>>also like the way the httpd docs are.  Any problem with this?
>
>
> When the docs are on the website, how will we navigate back to the
> Project and Welcome information if there are no tabs.
>

The breadcrumbs and logo link back to the main site, although that may
not be obvious.  http://httpd.apache.org/docs-2.0/ only has breadcrumbs;
I think it is okay.

> --David
>
>
>>David Crossley wrote:
>>
>>>This was deliberate. We will eventually need to find a better way
>>>to link separate sets of documentation. Apache Cocoon has this
>>>same issue.
>>>
>>>The full URLs is not a proper solution. Apache websites need to be
>>>able to be mirrored. For example, this coming weekend all Apache
>>>websites are going to fail-over to eu.apache.org while infrastructure
>>>work is being done.
>>>
>>>--David
>>>
>>>
>>>
>>>>Author: brondsem
>>>>Date: Wed Mar 16 11:27:36 2005
>>>>New Revision: 157791
>>>>
>>>>URL: http://svn.apache.org/viewcvs?view=rev&rev=157791
>>>>Log:
>>>>these tab links were breaking; point to the full url of the files created
>>>
>>>>from docs-author
>>>
>>>>Modified:
>>>>  forrest/trunk/site-author/content/xdocs/tabs.xml
>>>>
>>>>Modified: forrest/trunk/site-author/content/xdocs/tabs.xml
>>>>URL:
>>>>http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/tabs.xml?view=diff&r1=157790&r2=157791
>>>>==============================================================================
>>>>--- forrest/trunk/site-author/content/xdocs/tabs.xml (original)
>>>>+++ forrest/trunk/site-author/content/xdocs/tabs.xml Wed Mar 16 11:27:36
>>>>2005
>>>>@@ -35,7 +35,7 @@
>>>>
>>>>   <tab id="home" label="Welcome" dir=""/>
>>>>   <tab id="project" label="Project" dir="" indexfile="contrib.html"/>
>>>>-    <tab id="docs" label="Documentation" dir="docs/"/>
>>>>-    <tab id="howto" label="How-To" dir="howto/"/>
>>>>+    <tab id="docs" label="Documentation"
>>>>href="http://forrest.apache.org/docs"/><!-- change to /docs/0.7 after
we
>>>>make the 0.7 release and get rid of 0.6 doc structure -->
>>>>+    <tab id="howto" label="How-To"
>>>>href="http://forrest.apache.org/howto"/><!-- change to /docs/0.7/howto
-->
>>>>
>>>></tabs>
>>>
>>>
>>>-------------------------
>>>
>>>Author: brondsem
>>>Date: Wed Mar 16 09:46:03 2005
>>>New Revision: 157779
>>>
>>>URL: http://svn.apache.org/viewcvs?view=rev&rev=157779
>>>Log:
>>>documentation stands alone, not integrated with the project site
>>>
>>>Modified:
>>>   forrest/trunk/docs-author/content/xdocs/tabs.xml
>>>
>>>Modified: forrest/trunk/docs-author/content/xdocs/tabs.xml
>>>URL:
>>>http://svn.apache.org/viewcvs/forrest/trunk/docs-author/content/xdocs/tabs.xml?view=diff&r1=157778&r2=157779
>>>==============================================================================
>>>--- forrest/trunk/docs-author/content/xdocs/tabs.xml (original)
>>>+++ forrest/trunk/docs-author/content/xdocs/tabs.xml Wed Mar 16 09:46:03
>>>2005
>>>@@ -36,8 +36,6 @@
>>><!-- FIXME: FOR-447
>>>    <tab id="home" label="Welcome" dir="../../"/>
>>>-->
>>>-    <tab id="home" label="Welcome" dir=""
>>>indexfile="../../mail-lists.html"/>
>>>-    <tab id="project" label="Project" dir=""
>>>indexfile="../../contrib.html"/>
>>>    <tab id="docs" label="0.7-dev Documentation" dir="/"
>>>    indexfile="index.html">
>>>      <tab id="core" label="Core" indexfile="your-project.html"/>
>>>      <tab id="forrestbor" label="ForrestBot"
>>>      indexfile="forrestbot.html"/>
>
>


--
Dave Brondsema : dave@brondsema.net
http://www.splike.com : programming
http://csx.calvin.edu : student org
http://www.brondsema.net : personal

Mime
View raw message