[fossil-users] Repository home page as embedded documentation

[Paul Higham]

I am using markdown to document an application within Fossil. Having read all 
the documentation I could find I still cannot see whether it is possible to do 
the following:

have the home page of the repository be rendered from a file such as 
homePage.md where this file is itself under source control in the same 
repository (this way I could edit the home page in my favourite text editor)
from a wiki page written using markdown, create a link to another wiki page 
also written using markdown

Are either of these possible or do I have to edit the first page in the wiki 
page editor and go under the hood to create the query string to access the 
linked wiki page?

Thanx!

:: paul___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

Re: [fossil-users] Repository home page as embedded documentation

[Andy Bradford]

Thus said Paul Higham on Wed, 09 Dec 2015 16:32:53 -0800:

> have the home page  of the repository be rendered from  a file such as
> homePage.md where this file is itself under source control in the same
> repository (this way  I could edit the home page  in my favourite text
> editor) from  a wiki  page written  using markdown,  create a  link to
> another wiki page also written using markdown

This   is  precisely   how   Fossil  does   it   using  the   ``Embedded
Documentation''  feature if  you look  at www.fossil-scm.org  you'll see
that  the default  Home Page  is  not a  wiki  at all,  but an  embedded
document that is revision controlled:

http://www.fossil-scm.org/index.html/artifact/89c650d5efb9273a

Login  to your  Fossil repository  and navigate  to Admin->Configuration
(/setup_config page), then  change the Index Page setting  from /home to
/doc/tip/www/homePage.md (or whatever the path  is in your repository to
homePage.md).

If you want  this page to be publicly visible  without logging in you'll
also  need  to  visit  Admin->Access (/setup_access  page)  and  include
/doc/tip/www/* in your Public Pages setting.

Andy
-- 
TAI64 timestamp: 40005668f364


___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users