On Mon, 7 Feb 2005, Jean-Marc Lasgouttes wrote: > chr> But in general I agree with you: If the document comtains > chr> advanced typography, or lots of figures/formulas, it should > chr> definitely *not* be a wiki page. We should only "wikify" stuff > chr> that is mostly text and where it is primarly the content that > chr> matters - not how it looks. Nor when it might be of interest to > chr> use it as an example of a .lyx-document. > > Also, there is the problem that trying to get people to use an editor > and using something else for our own docs is fishy, I think...
I think that's a very good motivation for authoring the help documents using LyX. So why aren't we using LyX for this? What are the advantages with using wiki pages? (compared to writing help as .lyx-files) * Everybody can edit a wiki page (even simultanoeusly in pmwiki-2) * Everybody can add a new wiki page * Creating links on a wiki page is trivial * Browsing wiki pages and following links is trivial * The wiki pages are interactive, changes take effect immediately I'm not sure all of this is desirable for "official" documentation that's shipped with LyX though... Would it make sense if LyX could be used together with sort of a "wiki"? For instance, what if a "wiki page" actually is a LyX-document stored on a server, and LyX users can: * Download, edit, upload the page * View "wiki pages" using LyX as browser (this includes being able to follow links by clicking on them) * Perhaps it'd also be possible to export the pages as HTML and thus generate a set of HTML-pages that are browsable as normal? I suspect something like this would make it possible for us to have a wiki which would be used and maintained via LyX, i.e. the documentation would be read and created using LyX. But would this be something we want LyX to do, or is it creeping featurism? Anyway, I have a feeling that as it is right now, the wiki pages are better for collaborative editing of information, whereas LyX is better for creating individual documents. Right now I'm therefore more interested in deciding what documentation is better of as .lyx-files, and what kind of information that is better off as wiki pages. > chr> Eh... I thought you asked why LyX is unsuitable for reading > chr> documents with? Anyway, I just wanted to say that I think there > chr> are reasons why LyX is less good for browsing documentation. > chr> (OTOH, I think it's awesome as an authoring tool). > > I meant that we do not have such large equations in the manuals. I > agree that the problem is annoying. Oh, now I understand. Btw, writing the above made me realize that I miss the 'link'-ability of the wiki page... Can we put clickable links inside a LyX-document: * Link to another part of the same document (this we have already, right?) * Link to another document? * Link to another part inside another document? I guess this is something I miss from working with the wiki pages. /Christian -- Christian Ridderstr�m, +46-8-768 39 44 http://www.md.kth.se/~chr
