On Sun, Jan 16, 2011 at 5:24 AM, David Bovill <[email protected]> wrote:
> One think I'm missing in terms of usability is the ability to intimately
> link a particular source code file with a wiki page. AFAIK this is not part
> of the structure or interface at the moment - so no wiki-tags for linking to
> / embedding the source code from the wiki.
>
> It seems that this may be partly possible by creating your own custom header
> in the wiki page - but there is no equivalent for the file display page?
> basically I want to have two-way links between the source code file and a
> root documentation page.
Do you mean only in Fossil's file display, or are you looking for a
way to automatically have a link in the source file's header back to a
wiki page?
If Fossil were to support a $Documentation$ keyword in source files, I
could see such an automated link in a source file.
Another thought that occurs to me is that source code could be
embedded in .wiki files using the <code> or <verbatim> tags. A rule in
your makefile or build script would define how to extract the source
from a .wiki file. For example, a make rule for C++ source would be:
.wiki.cpp:
sed -n -e '\#<code>#,\#</code># p' $? | sed -e '\#</?code># d' >$@
This would allow extensive documentation, as well as wiki markup, to
be interleaved with the code.
_______________________________________________
fossil-users mailing list
[email protected]
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users
