[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: open tag and uppercase tag

Il giorno Mon, 7 Jun 2010 16:41:27 +0200


Gerfried Fuchs <rhonda@deb.at> ha scritto:

> 	Hi!
>  Not sure if you are subscribed yet - please forgive me the additional
> mail if you are.

Yes, I am. But your reply is so exhaustive and complete that you're
forgiven! ;)

> * Francesca Ciceri <madamezou@yahoo.it> [2010-06-04 10:47:51 CEST]:
> > I'm a member of italian l10n team and currently I'm working on web
> > site's pages, but I have a doubt: when I translate a page I often
> > see in the english version some open tag or uppercase tag and I fix
> > them (both in the english and italian page). I think that I have to
> > fix it in all languages as explained here [1] but I'm not sure,
> > so..here I am!:D
>  It might be convenient and tempting to convert them all to lowercase,
> but actually that's a job that WML itself does it is best to avoid
> that to not annoy translators. 

Yes, I know that it's not properly "my job/task" but I'm that kind of
person who straight crooked picture on the wall, so if I notice
something wrong I'll try to fix it...But I also take the lesson, this
time: I have to document myself a little more on (X)HTML before
committing! :D

>  This requires a complete (and current) checkout of the complete
> webwml CVS tree, and using the smart_change.pl tool is there to avoid
> mistakes at this stage.
>  For doing such changes I would do like follows, with 
> $> ./smart_change.pl -s
> s,somethingthatisntthere,somethingthatisntthere, \
> english/file/to/change.wml
>  Then open */file/to/change.wml in the editor of your choice, adjust
> the casing of the tags that bothers you much and quit. Please
> tripple-check with cvs diff wether your change was proper, like
> written on the page, then commit them all in one go.
>  Please notice that your addition of closing paragraph tags in
> webwml/english/devel/website/using_cvs.wml unfortunately wasn't proper
> because <pre> tag can't be nested inside <p> tags. 

Yes, I'm sorry for that. But now, I've read some docs and attached
there's my "intent of commit"
for /webwml/english/devel/website/using_cvs.wml ("oh no!not *again*!"):
I think this version it's ok, but I would like to have some feedback
before commit it.

>  Thanks for your effort anyway, and welcome to the group!
> Rhonda

Thank you for the reply and the mini-howto!


#use wml::debian::template title="Using CVS"

<p>CVS is a program to help manage having multiple people work on
the same material simultaneously. Every user creates a local copy
of the main repository. The local copies can be on the same machine,
or across the world. Users can then modify the local copy as they
wish and when the modified material is ready, commit the changes
back to the main repository.</p>

<p>For a read only access it's possible
to use the <a href="http://cvs.debian.org/webwml/?root=webwml";>web
frontend</a>. There exist also many graphical CVS clients such as
KDE's <a href="http://packages.debian.org/cervisia";>cervisia</a>.
This document describes the workflow with the command line program
<code>cvs</code>, other clients provide similar functionality.</p>

<p>CVS will not let you commit a file if the copy in the main
repository has been modified since your last update. This is
not normally a problem as you can still update your local copy.
If the modifications were to different parts than you were working
on, the changes are silently merged. If the changes affect the same area you
were working on, you will be warned that there is a conflict
and you need to edit the file to fix the problem before committing.</p>

<p>In what follows anonymous access will be used as an example. If
you have access to another account which gives you write permission to
the repository then you should use that account instead. If you
are planning on making changes, you should get an account before
starting as anonymous users cannot commit changes.  See <a
href="#write-access">the section on write access</a> for more

<p>To begin using CVS, you must first <code>login</code> to the CVS server</p>

   cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml login

<p>(just hit enter for the password here)</p>

<p>To check out a copy of the wml files on your local machine, you need to use</p>

   cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout webwml

<p>You can check out a subset of the pages like this:</p>

   cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout -l \\
          webwml webwml/&lt;<var>language</var>&gt;
   cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout \\
          webwml/Perl webwml/english/template webwml/&lt;<var>language</var>&gt;/Pics
   cvs -d :pserver:anonymous@cvs.alioth.debian.org:/cvsroot/webwml checkout \\
          webwml/&lt;<var>language</var>&gt;/&lt;<var>path to desired files</var>&gt;

<p>Repeat for all subdirectories or files that you want. The second line
includes all the files you will need if you wish to create HTML from the WML
files. Partial checkouts such as these aren't really supported, though, so
the above instructions may not always work.</p>

<p>If you have been given a username with a password, insert that instead
of anonymous, like this:</p>

   cvs -d :ext:username@cvs.debian.org:/cvs/webwml checkout webwml/english/doc

<p>From then on, you will not need to use the <code>'-d :ext:...'</code>
part. Every few days you will want to do a</p>

   cvs update -d

<p>to retrieve any files from the repository which have changed.  The
<code>-d</code> update option will add any new directories, automatically.
You may want to create a <code>~/.cvsrc</code> file so that you don't have
to type some options all the time. For example, it can contain:</p>

cvs -z9
update -d -P
diff -u

<p>The following is for those who have write permission on the repository.
When you are done with a page, you can commit your changes to the repository using</p>

   cvs commit &lt;file&gt;.wml


   cvs commit &lt;dir&gt;    (to commit all the changes in &lt;dir&gt;)


   cvs commit          (to commit all changes from the current dir down)

<p>If you are the first person translating a page, you need to do</p>

   cvs add &lt;file&gt;.wml

<p>before you commit it. Note that <code>cvs add</code> is not recursive so
you need to add a directory before you can add its contents.</p>

<p>For more information on CVS, use <code>info cvs</code>.</p>

<h3><a name="write-access">CVS Write Access</a></h3>

<p>To obtain write access to the website, please <a
to join the <code>webwml</code> project on Alioth</a>.</p>

Reply to: