translation-quick-start-guide

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

 



-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi all,

There were some mistakes in the translation-quick-start-guide

- - https://bugzilla.redhat.com/show_bug.cgi?id=456258
- - https://bugzilla.redhat.com/show_bug.cgi?id=456268
- - https://bugzilla.redhat.com/show_bug.cgi?id=456269

I fixed this three bug reports.  Can please somebody check and verify
the syntax of the attached file?  In case I messed up the file.  And
then upload it to the CVS.

Please rebuild the pot file for the translation.

Kind regards,

Fabian

- --
Fingerprint: 2F6C 930F D3C4 7E38 6AFA 4EB4 E23C D2DD 36A4 397F

Fedora always leads and never follows.


-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org

iEYEARECAAYFAkivOBsACgkQ4jzS3TakOX9ZbwCfcM+ofgv7Oxa+pfUcTCX0wXS1
gvsAoIeDKGKva0lgB1uYxIw2AlWtNszN
=T2XQ
-----END PGP SIGNATURE-----
<!-- $Id: -->
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"; [

<!ENTITY % FDP-ENTITIES SYSTEM "fdp-entities.ent">
%FDP-ENTITIES;

<!ENTITY % DOC-ENTITIES SYSTEM "doc-entities.ent">
%DOC-ENTITIES;

]>
  
<section id="sn_accounts">
  <title>Accounts and Subscriptions</title>
  <para>
    To become a Fedora Translator, you must sign up for accounts and
    subscriptions as described in this chapter.  If you have questions,
    post them on the fedora-trans-list, or ask for help via Internet
    Relay Chat, or <acronym>IRC</acronym>, at <systemitem
      class="fqdomainname">irc.freenode.org</systemitem> on channel
    <systemitem>#fedora-l10n</systemitem>.
  </para>  
  <section id="signup-ml">
    <title>Subscribing to the Mailing List</title>
    <procedure>
      <step>
	<para>
	  Visit <ulink
	    url="https://listman.redhat.com/mailman/listinfo/fedora-trans-list/"/> 
	  and subscribe to the main translation mailing list.
	</para>
      </step>
      <step>
	<para>
	  Wait for the confirmation email which contains a link to
	  confirm your subscription. Click the link to confirm your
	  subscription.
	</para>
      </step>
      <step>
	<para>
	  Check <ulink url="http://fedoraproject.org/wiki/L10N/Teams/"/>
	  to see if there is a special mailing list for your language.
	  If so, subscribe to that list too.
	</para>
      </step>
    </procedure>
  </section>

  <section id="sn-ssh-key">
    <title>Making a SSH Key</title>

    <para>
      If you already have an existing SSH key, you can use it for Fedora
      work.  In that case, proceed to <xref
	linkend="st-change-permissions"/> in the following procedure. If
      you do not have a SSH key yet, start with the first step below:
    </para>

    <procedure>
      <step>
	<para>
	  Enter the following command:
	</para>

	<screen><command>ssh-keygen -t rsa</command></screen>

	<para>
	  Accept the default location
	  (<filename>~/.ssh/id_rsa</filename>) and enter a passphrase.
	</para>
	<caution>
	  <title>Remember Your Passphrase</title>
	  <para>
	    You must have your passphrase to access to the CVS
	    repository.  It cannot be recovered if you forget it.
	  </para>
	</caution>
      </step>
      <step id="st-change-permissions">
	<para>
	  Change permissions to your key and <filename>.ssh</filename>
	  directory:
	</para>

	<screen><command>chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_rsa
chmod 644 ~/.ssh/id_rsa.pub</command></screen>

      </step>
      <step>
	<para>
		This public key (~/.ssh/id_rsa.pub) will be used for your &FED; account creation described  in <xref linkend="sn-apply-account"/>. 
	</para>
      </step>
    </procedure>
  </section>

  <section id="sn-gpg-key">
    <title>Making a GPG Key</title>
    <procedure>
      <step>
	<para>
	  Generate a key by typing in a command line:
	</para>			    
	<screen><command>gpg --gen-key</command></screen>
	<para>
	  A series of prompts guides you through the process. The
	  default values suffice in almost all cases. Remember to choose
	  a good password.
	</para>
	<tip>
	  <title>Choosing a Good Password</title>
	  <para>A good password:</para>
	  <itemizedlist>
	    <listitem>
	      <para>consists of uppercase and lowercase letters,
		numbers, punctuation, and other characters</para>
	    </listitem>
	    <listitem>
	      <para>does not include any words or names, with or without
		substitutions</para>
	    </listitem>
	    <listitem>
	      <para>is not the same as any other password used for other
		systems</para>
	    </listitem>
	  </itemizedlist>
	</tip>
      </step>
      <step>
	<para>
	  In the resulting text, find your key ID in the statement that
	  resembles "pub  1024D/1B2AFA1C". Your key ID is the 8
	  character "word" after the slash (<literal>/</literal>).  In
	  the previous example, the GPG Key ID is
	  <literal>1B2AFA1C</literal>.  Write down your key ID.
	</para>
      </step>
      <step>
	<para>
	  Export your public key to a public server so that others can
	  find it with the following command, substituting your key ID:
	</para>
	<screen><command>gpg --keyserver subkeys.pgp.net --send-keys <replaceable>GPGKEYID</replaceable></command></screen>
      </step>
      <step>
        <para>
		This GPG key ID will be used for your &FED; account creation described in <xref linkend="sn-apply-account"/>.
  	</para>
      </step>
    </procedure>
  </section>
  
  <section id="sn-apply-account">
    <title>Applying for an Account</title>
    <procedure>
      <step>
	<para>
	  To sign up for a &FED; account, first visit <ulink url="https://admin.fedoraproject.org/accounts/"/> and select
	  <guilabel>New Account</guilabel>. 
	</para>
      </step>
      <step>
	<para>
	  Fill in <guilabel>Username</guilabel>, <guilabel>Full Name</guilabel> and <guilabel>Email</guilabel>, and click <guibutton>Sign up!</guibutton>. Your password will be emailed to you.
	</para>
      </step>
      <step>
	<para>
		Go back to <ulink url="https://admin.fedoraproject.org/accounts/"/> and log in with your password. The welcome page will be displayed, and it reminds you that CLA is not completed and that a SSH key is not submitted.
	</para>
      </step>
      <step>
	<para>
		To submit public SSH key and GPG key ID, click <guilabel>My Account</guilabel> or go to <ulink url=" https://admin.fedoraproject.org/accounts/user/edit"/>. 
        </para>
      </step>
      <step>
	<para>
	  In the Edit Account (user_name) page, enter your GPG key ID in <guilabel>GPG Key ID:</guilabel> field. For the public SSH key, click <guilabel>Browse...</guilabel> button located next to <guilabel>Public SSH Key:</guilabel> field and specify your public SSH key.
  	</para>
      </step>
      <step>
	<para>
	  <guilabel>Telephone Number</guilabel> and <guilabel>Postal Address</guilabel> fields are also required to fill in for signing the CLA. These information is NOT accessible by others except admin groups. Please refer to Fedora Privacy Policy at  <ulink url=" http://fedoraproject.org/wiki/Legal/PrivacyPolicy"/>.
  	</para>
      </step>
      <step>
	<para>
	  Other fields will be displayed by any other member by visiting the user's view page.
	</para>
      </step>
      <step>
	<para>
	  Now click <guilabel>Save!</guilabel> located at the bottom of this page to save your information.
	</para>
      </step>
    </procedure>
  </section>
  
  <section id="sn-sign-cla">
    <title>Signing the CLA</title>
    <para>
      You must complete the Contributors License Agreement, or
      <acronym>CLA</acronym>.
    </para>
    <procedure>			    
      <step>
	<para>Visit <ulink url="https://admin.fedoraproject.org/accounts/"/> and login your account using your username and password obtained from the previous process.
	</para>
      </step>
      <step>
	<para>
	  In the Welcome page, click <guilabel>complete the CLA</guilabel> or go to <ulink url=" https://admin.fedoraproject.org/accounts/user/edit"/>.
	</para>
      </step>
      <step>
	<para>
	  If the information of telephone number and postal address have not been provided yet, the Edit Account (user_name) page will be appeared. Otherwise &FED; Contributor License Agreement page will be displayed. Read through the agreement carefully and click <guibutton>I agree</guibutton> if you are happy to do so. 
	</para>
      </step>
      <step>
	<para>
	  The user-view page is appeared and shows the <guilabel>CLA:</guilabel> field as <guilabel>CLA Done</guilabel>.
	</para>
      </step>
    </procedure>
  </section>
		    
  <section id="sn-join-cvsl10n">
    <title>Joining the <systemitem>cvsl10n</systemitem> Group</title>
    <procedure>
      <step>
	<para>
	  In the user-view page, click <guilabel>Apply For a new Group</guilabel> located in the left side bar. If you like to do this step sometime later, your user-view page can be reached at <ulink url="https://admin.fedoraproject.org/accounts/user/view/user_name"/>.
	 </para>
      </step>
      <step>
	<para>
	  Click <guilabel>C</guilabel> of the alphabet, it returns the list of the groups starting with 'c'.
	</para>
      </step>
      <step>
	<para>
	  Find the group name <guilabel>cvsl10n</guilabel> in the list and click <guilabel>Apply</guilabel>. 
	</para>
      </step>
      <step>
	<para>
	  An administrator is notified of your application, and offers to sponsor you. This may take between an hour and a few days. The membership notification will be emailed to you once sponsored. 
	</para>
      </step>
    </procedure>
    <caution>
      <para>
	The rest of the steps help you test your access and grant you
	privileges to all the &FED; infrastructure you might need in
	the near future. Language maintainers and people starting new
	languages should follow them. Although they are optional for
	translations, everyone is encouraged to follow them.
      </para>
    </caution>
  </section>
    
  <section id="sn-test-access">
    <title>Testing Your Access</title>
    <procedure>
      <step>
	<para>
	  Install the <package>cvs</package> package, if it is not
	  already installed, with the following command:
	</para>
	<screen><command>su -c 'yum install cvs'</command></screen>
      </step>
      <step>
	<para>
	  Checkout some PO files with the following command, substituting your
	  username and providing your SSH key passphrase when prompted:
	</para>
	<screen><command>export CVSROOT=:ext:<replaceable>username</replaceable>@cvs.fedoraproject.org:/cvs/l10n
cvs co web
ls web/flpweb/po</command></screen>
      </step>
    </procedure>
  </section>
			    
  <section id="sn-create-wikiacct">
    <title>Creating a Wiki Account</title>
    <procedure>
      <step>
	<para>
	  A current wiki user can give you Edit access on the wiki. Contact someone from the Edit Group at <ulink url="http://fedoraproject.org/wiki/EditGroup/"/>, or add your name to the EditGroupQueue at <ulink url="http://fedoraproject.org/wiki/EditGroupQueue/"/>, and someone will add you shortly.
	</para>
      </step>
      <step>
	<para>
	  Once added, Visit <ulink   url="http://fedoraproject.org/wiki/UserPreferences/"/> and create a profile page. For your username, choose a name like 'FirstnameLastname' and select <guilabel>Create Profile</guilabel>.
	</para>
      </step>
      <step>
	<para>
	  If you are starting a new language, or want to become the
	  maintainer of one, add your information on the L10N/Teams page
	  at <ulink url="http://fedoraproject.org/wiki/L10N/Teams/"/>.
	</para>
      </step>
    </procedure>
  </section>
    
  <section id="sn-intro-yourself">
    <title>Introducing Yourself</title>
    <procedure>
      <step>
	<para>
	  Once you have edit access on the wiki, create a personal
	  page.  
	  at a URL like this: <ulink
	    url="http://fedoraproject.org/wiki/FirstnameLastname/"/>.
	  This is very useful for Fedora contributors to get to know and
	  contact each other.
	</para>
      </step>
      <step>
	<para>
	  Post a short self introduction <ulink
	    url="http://fedoraproject.org/wiki/L10N/Join/SelfIntroduction/"/> 
	  to the <systemitem>fedora-trans-list</systemitem> mailing list
	  and to the list of your local team.
	</para>
      </step>
    </procedure>
  </section>

  <section id="sn-bugzilla-account">
    <title>Create a &BZ; account</title>
    <para>
      Visit <ulink
	url="https://bugzilla.redhat.com/bugzilla/createaccount.cgi/"/>
      to create a &BZ; account.
    </para>
  </section>
	  
  <section id="sn-check-list">
    <title>Checklist</title>
    <para>
      You should now have the following:
    </para>
    <itemizedlist>
      <listitem><para>Subscription to fedora-trans-list mailing list
	  and your locale-specific mailing list, if there is
	  one</para></listitem>
      <listitem><para>A SSH key</para></listitem>
      <listitem><para>A GPG key</para></listitem>
      <listitem><para>A &FED; account</para></listitem>
      <listitem><para>Membership in the <systemitem>cvsl10n</systemitem>
	  group</para></listitem>
      <listitem><para>A wiki account</para></listitem>
      <listitem><para>Your language and translation team appear on
	  <ulink
	    url="http://fedoraproject.org/wiki/L10N/Teams/"/></para></listitem>
      <listitem><para>A &BZ; account</para></listitem>
      <listitem><para>A personal homepage on the wiki</para></listitem>
      <listitem><para>A self-introduction sent to the mailing
	  list</para></listitem>
    </itemizedlist>
    <para>
      Sit back and enjoy your achievement. You are now a fully
      recognized member of the Fedora community, capable of digitally
      signing documents and emails, submitting contributions to our CVS,
      publishing content on the wiki, submitting bugs, following the
      discussions of our groups and joining other Fedora teams.
    </para>
  </section>

  </section>
  
<!--
Local variables:
mode: xml
fill-column: 72
End:
-->
-- 
fedora-docs-list mailing list
fedora-docs-list@xxxxxxxxxx
To unsubscribe: 
https://www.redhat.com/mailman/listinfo/fedora-docs-list

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux