Twisted: Ticket #3438: Being able to link to howtos in different subprojectshttps://twistedmatrix.com/trac/ticket/3438
<p>
From <a class="closed ticket" href="https://twistedmatrix.com/trac/ticket/1404" title="#1404: defect: Bad link in twisted web documentation (closed: fixed)">#1404</a>: In a subproject howto, there's no way to express a link to a howto in a different subproject. This is a documentation generation issue.
</p>
en-usTwistedhttps://twistedmatrix.com/trac/chrome/common/trac_banner.pnghttps://twistedmatrix.com/trac/ticket/3438
Trac 1.2GlyphSun, 21 Sep 2008 12:39:07 GMThttps://twistedmatrix.com/trac/ticket/3438#comment:1
https://twistedmatrix.com/trac/ticket/3438#comment:1
<p>
As far as I know there is a way to do this. If the link were expressed in the lore source as "../../core/howto/defer.xhtml", some invocations of lore would work properly with it.
</p>
<p>
There's currently some (undocumented?) reshuffling of documents as part of the release process; I believe they're in a different structure on the website than in the download.
</p>
<p>
I'd like to resolve this by simply re-organizing the documentation generation process to be simply invoking 'lore' with no arguments in the 'doc' directory, which will (among other benefits) make relative links work properly. This is the way it originally worked on Twisted, and the way it currently works in <a class="ext-link" href="http://divmod.org/trac/browser/trunk/Mantissa/doc"><span class="icon">​</span>Mantissa trunk</a>. I don't think it would be too much work to do that.
</p>
<p>
(Now, there might be a <em>separate</em> feature which would allow arbitrary projects to link to each others' documentation in Lore somehow, but that's a different story entirely.)
</p>
TicketradixTue, 29 Sep 2009 00:42:58 GMThttps://twistedmatrix.com/trac/ticket/3438#comment:2
https://twistedmatrix.com/trac/ticket/3438#comment:2
<p>
Right, so this ticket is invalid: it is possible to do cross-subproject links, by using "../"*N as glyph suggested. There is no bug with lore here.
</p>
<p>
We do have a problem with the *deployment* of documentation on the web site, which I've created <a class="new ticket" href="https://twistedmatrix.com/trac/ticket/4044" title="#4044: task: we can't use cross-project links on the twisted web site while also ... (new)">#4044</a> for.
</p>
TicketradixTue, 29 Sep 2009 01:23:59 GMTstatus changed; resolution sethttps://twistedmatrix.com/trac/ticket/3438#comment:3
https://twistedmatrix.com/trac/ticket/3438#comment:3
<ul>
<li><strong>status</strong>
changed from <em>new</em> to <em>closed</em>
</li>
<li><strong>resolution</strong>
set to <em>invalid</em>
</li>
</ul>
Ticket