Re: [fossil-users] Moving Wiki/MD files between Wiki list on web UI and source tree, and previewing

[Thomas]

On 2018-03-13 17:37, Warren Young wrote:

On Mar 13, 2018, at 11:33 AM, Warren Young  wrote:


The examples above both show how you can have a common list of documentation 
that points to multiple sources.  My project’s example shows a manually-curated 
list, whereas the Fossil project example shows an automatically-generated 
index, done with the www/mkindex.tcl script in the Fossil source tree.


Also, realize that the links at the top of each Fossil UI page are just 
elements of the Header part of the skin.  drh has pointed his “Docs” link to 
his script-generated permuted index, and in my PiDP-8/I project, I’ve adjusted 
the “Wiki” link to point to /wcontent rather than to /wiki, which I think makes 
more sense.


I think this should be the default when clicking on Wiki in the top menu 
(/wcontent). This /wiki is somehow odd and needs getting used to.


___
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] Moving Wiki/MD files between Wiki list on web UI and source tree, and previewing

[Warren Young]

On Mar 13, 2018, at 11:33 AM, Warren Young  wrote:
> 
> The examples above both show how you can have a common list of documentation 
> that points to multiple sources.  My project’s example shows a 
> manually-curated list, whereas the Fossil project example shows an 
> automatically-generated index, done with the www/mkindex.tcl script in the 
> Fossil source tree.

Also, realize that the links at the top of each Fossil UI page are just 
elements of the Header part of the skin.  drh has pointed his “Docs” link to 
his script-generated permuted index, and in my PiDP-8/I project, I’ve adjusted 
the “Wiki” link to point to /wcontent rather than to /wiki, which I think makes 
more sense.

The point is, you’re not required to accept the Fossil-provided wiki link if it 
isn’t suiting your purposes.
___
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] Moving Wiki/MD files between Wiki list on web UI and source tree, and previewing

[Warren Young]

On Mar 13, 2018, at 9:43 AM, Tony Papadimitriou  wrote:
> 
> 1. I have some Wiki/MD files created from the web UI.  Can I move them to the 
> source tree and still keep access to them from the web UI?

That’s the whole point of the embedded documentation feature:

   https://fossil-scm.org/index.html/doc/trunk/www/embeddeddoc.wiki

Examples:

1. Everything in Fossil’s own permuted index is embedded documentation:

   https://fossil-scm.org/index.html/doc/trunk/www/permutedindex.html

2. Scroll to the bottom on the home page of my PiDP-8/I project; much of the is 
embedded documentation, which you can tell by the “/pidp8i/doc/trunk” prefixes 
in the URLs:

   https://tangentsoft.com/pidp8i/wiki?name=Home

Many of those links are also to unversioned content, which provides a useful 
tradeoff in some cases:

   https://fossil-scm.org/index.html/doc/trunk/www/unvers.wiki

> And the reverse.

I’m not quite sure what you mean by that.

If you’re simply asking if you can take an embedded document’s content and 
create a wiki article from it, of course you can.  The URL will change, but if 
that’s a problem, you can fix that at the front-end proxy layer with URL 
rewriting.  The URL aliasing feature added in 2.4 might also help.  (Admin > 
URL Aliases.) 

> 2. I have some Wiki/MD files in the source tree (which I can see with the 
> http://repo/doc/version/filename.[md/wiki] link) but I cannot figure out how 
> to associate that link as a Wiki page shown in the Wiki list of the Web 
> interface.

The wiki and embedded docs are different things, useful for different purposes.

A document goes in the wiki when its history is not tied to the history of the 
repository itself: when you roll back to a prior version in the timeline, 
“fossil ui” continues to show the newest version of all wiki documents, whereas 
embedded documentation rolls back to contemporaneous versions.  Therefore, use 
the wiki for “evergreen” content, and the embedded documentation feature for 
documentation that evolves in lockstep with the repository content.

The examples above both show how you can have a common list of documentation 
that points to multiple sources.  My project’s example shows a manually-curated 
list, whereas the Fossil project example shows an automatically-generated 
index, done with the www/mkindex.tcl script in the Fossil source tree.

> 3. Is there a more ‘immediate’ command-line method to review my source-tree 
> Wiki/MD file(s) before committing my changes?
> I mean some way to see how the Wiki/MD will actually show.  Can I do ‘fossil 
> ui’ followed by some option to do this?

You’re looking for the “ckout” special name, documented here:

   https://fossil-scm.org/index.html/doc/trunk/www/checkin_names.wiki

You use it in place of “version” in the example URLs you give in your original 
post, rather than “trunk” or some other version tag.
___
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users