<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html; charset=windows-1252"
http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
On 11/30/10 11:40 PM, Louis Desjardins wrote:
<blockquote
cite="mid:AANLkTimKjgw6hc=tJ_vQQRdPQaepjvY=dR_Cd9=P0uSR@mail.gmail.com"
type="cite">2010/11/30 Craig Bradney <span dir="ltr"><<a
moz-do-not-send="true" href="mailto:cbradney@scribus.info">cbradney@scribus.info</a>></span><br>
<div class="gmail_quote">
<blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt
0.8ex; border-left: 1px solid rgb(204, 204, 204);
padding-left: 1ex;">
<div bgcolor="#ffffff" text="#000000">
<div class="im"> On 11/30/10 11:26 PM, Louis Desjardins
wrote:
<blockquote type="cite">2010/11/30 Gregory Pittman <span
dir="ltr"><<a moz-do-not-send="true"
href="mailto:gpittman@iglou.com" target="_blank">gpittman@iglou.com</a>></span><br>
<div class="gmail_quote">
<blockquote class="gmail_quote" style="margin: 0pt 0pt
0pt 0.8ex; border-left: 1px solid rgb(204, 204,
204); padding-left: 1ex;">
<div>On 11/30/2010 02:24 PM, Louis Desjardins wrote:<br>
<blockquote class="gmail_quote" style="margin: 0pt
0pt 0pt 0.8ex; border-left: 1px solid rgb(204,
204, 204); padding-left: 1ex;"> <br>
I am not too sure to understand either just how
the doc workflow works.<br>
<br>
Can we translate the doc? can we help write it?
can this job be on a<br>
wiki? (so we can work on it step by step, from
time to time, alone or in<br>
a group of people). How can we improve the doc
workflow, in fact.<br>
</blockquote>
<br>
</div>
Anyone can translate the docs. Simply pull them out
of their location and edit away. Usually what I see
people do on the wiki, which makes sense, is to copy
the original, then stepwise work through the html
file paragraph by paragraph, leaving the tags other
structure in place as you go.<br>
<br>
The structure of the docs directories and files is
pretty straightforward, as is the XML file that
forms the index. I have sent Christoph anything I
make, since he has commit rights and I don't.</blockquote>
<div><br>
</div>
<div>Do we need commit rights to edit an online doc
file? Or to submit a translation? My understanding
of this is it’s tied to the application only by a
URL. Thus, in no way does that affect the code. It’s
a simple link to a website.</div>
</div>
</blockquote>
<br>
</div>
You download the file from SVN, translate it, submit it to
Christoph so he can commit it.</div>
</blockquote>
<div><br>
</div>
<div>What do I do if I want to help write the file on the first
place? <br>
</div>
</div>
</blockquote>
<br>
Write the content in plain text format and send it to Christoph..
add the HTML tags if you wish for bold, italic, paragraphs etc if
you wish. He can clarify what he would expect
easiest/best/harder/worse.<br>
<blockquote
cite="mid:AANLkTimKjgw6hc=tJ_vQQRdPQaepjvY=dR_Cd9=P0uSR@mail.gmail.com"
type="cite">
<div class="gmail_quote">
<blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt
0.8ex; border-left: 1px solid rgb(204, 204, 204);
padding-left: 1ex;">
<div bgcolor="#ffffff" text="#000000">
<div class="im"><br>
<br>
<blockquote type="cite">
<div class="gmail_quote">
<div>Can we turn this into a wikipedia-like way to go?
If for some reason someone makes an error and mixes
things or deletes some content, we have ways to
return to the previous stage. I see a lot of
disadvantages at pulling out a file, edit away and
then pushing it back, while there are ways to work
in a collaborative (and sync) mode.</div>
</div>
</blockquote>
<br>
</div>
We have SVN.. which contains the history of Scribus for
(almost) ever... <br>
<br>
I do not believe we have a nice way of extracting from a
wiki to our html format.<br>
</div>
</blockquote>
<div><br>
</div>
<div>There is something I don’t get, obviously. :)</div>
</div>
</blockquote>
See the SVN checkout info on docs.scribus.net or the wiki.<br>
<br>
<blockquote
cite="mid:AANLkTimKjgw6hc=tJ_vQQRdPQaepjvY=dR_Cd9=P0uSR@mail.gmail.com"
type="cite">
<div class="gmail_quote">
<div><br>
</div>
<div>Why should we extract something? When we edit a wikipedia
page, we edit the actual page that is shown to the rest of the
world.</div>
<div><br>
</div>
<div>The only purpose I would see that would require to extract
something is when we would like to produce a book out of the
content of the online doc, using a Scribus template for
instance. Then, yes, we would need to extract something.<br>
</div>
</div>
</blockquote>
<br>
We have no intention of producing an online site only. Christoph is
writing documentation that appears under the Help->Scribus Manual
menu entry, as distributed with Scribus. We have a process that
automatically checks out those HTML files and does some data
massaging into the format you see on docs.scribus.net... so.. from 1
HTML file we get a shipped HTML file with the installed software,
plus the online version at docs.scribus.net.<br>
<br>
There is, and never has been, any intention of producing a book from
this content.<br>
<br>
Craig<br>
<br>
</body>
</html>