10:55 p.m.
Hello,
Could someone tell me what is the best way to compare, for instance the
English and the French version of the user manual ? Is there a text editor
with an XML parser or something like that, in order to have both
versions one next to the other ? Or does everyone use a simple text editor ?
Pierre
On 9/28/07, Elisa-yemanja <yemanja@...4...> wrote:
---------- Message transmis ----------
Sujet: Re: [Inkscape-docs] splitting user manual
Date: jeudi 27 septembre 2007
De: "radar.map35@...6..." <radar.map35@...6...>
À: Elisa-yemanja <yemanja@...4... >
png, not big of course, but we could also include some SVG when needed ;)
no i just thought on :
- when should we produce picture ?
- when should we update ?
- is there any tool to do it automatically : i've heard on one used by
RedHat but don't know much (may be Andyfitz does).
- what naming guideline ?
- what directory structure to be sure that our Makefile works fine in
any cases
and things like that
pygmee
-------------------------------------------------------
--
Elisa
-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2005.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Inkscape-docs mailing list
Inkscape-docs(a)lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/inkscape-docs
11:43 p.m.
On 9/28/07, Pierre Jacob wrote:
Hello,
Could someone tell me what is the best way to compare, for instance the
English and the French version of the user manual ? Is there a text editor
with an XML parser or something like that, in order to have both versions
one next to the other ? Or does everyone use a simple text editor ?
Hi,
Don't know for others, but I use Gedit - the default GNOME text editor
with syntax highlight.
Earlier we planned to work on new outline first, but it looks like
with 4 people around EN-FR user guides already waiting to get started
or even contributing this will be a major show-stopper.
I have already splitted English user guide into several smaller files
on one-chapter-per-file basis and I'll commit changes as soon as I get
back home. I will do the same for French user guide later today or
tomorrow. Then it will be easier to compare them and sync content,
while restructuring is on planning stage.
As for comparison, if I were you, I would probably use either GVim or
Kate: both can show two documents at the same time in different panes,
IIRC.
Alexandre
2:49 a.m.
On 9/28/07, Pierre Jacob wrote:
> Hello,
> Could someone tell me what is the best way to compare, for instance the
> English and the French version of the user manual ? Is there a text editor
> with an XML parser or something like that, in order to have both versions
> one next to the other ? Or does everyone use a simple text editor ?
I use Meld also, which is a nice but simple gtk visual diff tool. It
does not do parsing, however.
As far as a syntax editor, Bluefish is really nice, and you can have
multiple docs open simultaneously, but you can't view them
simultaneously. If you could merge it with meld and get both diff and
syntax, it would be perfect.
I'm also playing with Conglomerate, a very simple visual docbook editor,
which looks to be very nice. The only think I've notice is that it's
really slow to render when you change the size of panes or the window.
Other than that, my first impression is that it is really slick.
3:37 a.m.
I have already splitted English user guide into several smaller
files
on one-chapter-per-file basis and I'll commit changes as soon as I get
back home. I will do the same for French user guide later today or
tomorrow. Then it will be easier to compare them and sync content,
while restructuring is on planning stage.
I think it would save trouble to split it before we really get started,
but if you've got it already split into chapters, I think that will be
good for now.
The main question I have right now is whether you want to sync all the
document info. For instance, the French has:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY nbsp " ">
<!-- FIXME: half-space doesn't work <!ENTITY eg
"e. g.">-->
<!ENTITY eg "e. g.">
<!ENTITY hellip "…">
]>
whereas the English only has;
<?xml version="1.0"?>
<!-- SYSTEM "/usr/share/xml/docbook/schema/dtd/4.3/docbookx.dtd" -->
Also, is it okay to change the comments such as:
<!-- CAPTURE D ECRAN OU BOITE DE DIALOGUE -->
<!-- DESCRIPTION D OUTIL -->
to such as:
<!-- SCREEN CAPTURE OR DIALOG BOX -->
<!-- TOOL DESCRIPTION -->
or are those custom handling tags?
JF
5722
days inactive
5722
days old
inkscape-docs@lists.inkscape.org
3 comments
3 participants
participants (3)
-
Alexandre Prokoudine -
Joshua Facemyer / Impressus Art -
Pierre Jacob