Edit Markup/es: Difference between revisions

From KDE TechBase
(Created page with "== Flujo de trabajo Etapa 1 ==")
(Updating to match new version of source page)
 
(6 intermediate revisions by 2 users not shown)
Line 2: Line 2:
== Herramientas disponibles ==
== Herramientas disponibles ==


* [[Typographical_Guidelines]] standardizes markup for use in translation, either to official manuals (DocBook) or to other languages. Please refer to this frequently, as markup will be refined to match translators' needs.
* [[Special:myLanguage/Typographical_Guidelines|Typographical guidelines]] standardizes markup for use in translation, either to official manuals (DocBook) or to other languages. Please refer to this frequently, as markup will be refined to match translators' needs.


== Flujo de trabajo Etapa 1 ==
== Flujo de trabajo Etapa 1 ==
Line 8: Line 8:
=== Correcting old markup ===
=== Correcting old markup ===


* Check that every heading for sections and subsections has an empty line following it.
* Checa que cada cabecera de sección y subsección tengan una linea vacía siguiéndola.


* Many pages have multiple indents set. This was included in earlier mediawiki documentation, but is not longer acceptable as it causes problems for exporting to other formats, so please re-arrange, using single indents only. Bullets can continue to be used nested.
* Muchas paginas tienen múltiples estilos de indentación . Esto fue incluido en documentación anterior de mediawiki, pero no ya no es aceptable porque causa problemas al exportar a otros formatos, asi que por favor re-ajustar, usando solamente indentación simple. Las viñetas pueden seguir anidadas.


* ASCII smilies cause problems and must be removed. They can be replaced by oxygen icons in a small size (11px?). Many more are available from Wikimedia Commons - details to be added here.
* Las caritas ASCII causan problemas y deben ser removidas. Estas pueden ser reemplazadas con iconos de oxygen en una medida pequeña (11px?). Muchos mas están disponibles en Wikimedia Commons - detalles serán añadidos aquí.


* Internal links in the form <nowiki>[[Translation Workflow]]</nowiki> should be edited to the complete form, showing link, then visible text such as <nowiki>[[Special:myLanguage/Translation_Workflow|Translation Workflow]]</nowiki>
* Internal links in the form <nowiki>[[Translation Workflow]]</nowiki> should be edited to the complete form, showing link, then visible text such as <nowiki>[[Special:myLanguage/Translation_Workflow|Translation Workflow]]</nowiki>
Line 32: Line 32:
=== Marking Links for Translation ===
=== Marking Links for Translation ===


* A stand-alone link, such as the application-names in Applications/Internet, should use the form <nowiki>[[Special:myLanguage/Ark|<translate>Ark</translate>]]</nowiki>
* A stand-alone link, such as the application-names in Applications/Internet, should use the form <nowiki>[[Special:myLanguage/Ark|&lt;translate>Ark &lt;/translate>]]</nowiki>
* Where the link is within a sentence the whole of the link should be kept within the translatable message.
* Where the link is within a sentence; the whole of the link should be kept within the translatable message.


=== Special Tags ===
=== Special Tags ===
Line 62: Line 62:
{{Tip|1=Simplified definitions - ''Programs'' are launched by users, ''components'' are used by programs}}
{{Tip|1=Simplified definitions - ''Programs'' are launched by users, ''components'' are used by programs}}


== Issues that cause Translate problems ==
== Cosas que causan problemas de traducción ==


Several issues have been identified and discussed, and solutions proposed in the following sections:
Several issues have been identified and discussed, and solutions proposed in the following sections:
Line 76: Line 76:
* In the summary field at the bottom, enter that you are doing a markup edit.
* In the summary field at the bottom, enter that you are doing a markup edit.
* Use <menuchoice>Preview</menuchoice> and read through the whole of your work.  If you are satisfied, save the page.
* Use <menuchoice>Preview</menuchoice> and read through the whole of your work.  If you are satisfied, save the page.
* Use the link in the sidebar to request release - it takes you to a page where you can add the URL of the page you have edited.  Pasting your link there tells us that you believe the page to be ready for translators to work with.  We will scan it, and if satisfied we will enable it for translation.
* Use [[Special:myLanguage/ReadyForTranslation|this page]] to request release - you can add the URL of the page you have edited.  Pasting your link there tells us that you believe the page to be ready for translators to work with.  We will scan it, and if satisfied we will enable it for translation.


[[Category:Translator_Help]]
[[Category:Translator_Help]]

Latest revision as of 09:52, 10 February 2019

Herramientas disponibles

  • Typographical guidelines standardizes markup for use in translation, either to official manuals (DocBook) or to other languages. Please refer to this frequently, as markup will be refined to match translators' needs.

Flujo de trabajo Etapa 1

Correcting old markup

  • Checa que cada cabecera de sección y subsección tengan una linea vacía siguiéndola.
  • Muchas paginas tienen múltiples estilos de indentación . Esto fue incluido en documentación anterior de mediawiki, pero no ya no es aceptable porque causa problemas al exportar a otros formatos, asi que por favor re-ajustar, usando solamente indentación simple. Las viñetas pueden seguir anidadas.
  • Las caritas ASCII causan problemas y deben ser removidas. Estas pueden ser reemplazadas con iconos de oxygen en una medida pequeña (11px?). Muchos mas están disponibles en Wikimedia Commons - detalles serán añadidos aquí.
  • Internal links in the form [[Translation Workflow]] should be edited to the complete form, showing link, then visible text such as [[Special:myLanguage/Translation_Workflow|Translation Workflow]]
  • Many styles have been used to display input text, including <code>, <pre> and tables and boxes. Text intended to be input by the user should use the Input template, {{Input|1=input text (can be multi-line or single)}}. You can still use <code> for very short input, if you don't want the text to appear on a separate line.
  • Output from terminal and error messages have been similarly marked with a variety of methods. These should be replaced with the Output template, {{Output|1=terminal output}}
  • Every page should end with a Category statement. These must be standardized categories. A current list of categories can be found on any of the translators' pages linked from this language page
  • Make sure that there are no unbalanced brackets in any section. If you find unbalanced brackets then add the missing bracket(s) — possibly in a comment like this:
    <!--(--> a)
  • There should be a blank line between bullets in lists. See the sections on lists beginning with Bulleted Lists.
  • Tables should be split in a similar manner, so that there is a blank line between each row. The first and last items will need to have curly braces balanced.

Stage 2 - Guide to new markup

Marking Links for Translation

  • A stand-alone link, such as the application-names in Applications/Internet, should use the form [[Special:myLanguage/Ark|<translate>Ark </translate>]]
  • Where the link is within a sentence; the whole of the link should be kept within the translatable message.

Special Tags

  • Identify all keyboard key-names, and tag, e.g. <keycap>Enter</keycap>
  • Include concurrent keypresses in the <keycap> tag, e.g. Ctrl + Alt + F1. Note that the separator is (space)+(space)
  • Treat menu sequences in a similar manner, using the <menuchoice> tag, e.g.System Settings -> Account Details -> Social Desktop. Note that the separator is (space)->(space)
Warning
NEVER add translate section tags (the ones that look like < !--T:18-- >). The software will do any handling of tags that is required, and manually changing them will break the system.


Bold type

  • Identify program names and mark them as bold type, e.g. Klipper
  • Identify labels and names that cannot be changed by the user, and mark them as bold type.
  • Remove any bold type marking that were previously entered, but do not match this guideline. (See below for emphasizing a word or phrase.)
  • Window captions and Icon labels are also marked as bold type.

Italics

  • Italics can be used to give emphasis as you might in non-technical writing
  • Use italics on the first appearance of an unfamiliar word or phrase, and if possible link it to #Glossary or a dictionary entry.
  • When referencing other (external) works, titles are italicized.

Combined Bold and Italics

  • This should only be used in the context of an example where the user has to substitute text, e.g. "Your new addressbook records are in /home/user/share/contacts"
Tip
Simplified definitions - Programs are launched by users, components are used by programs


Cosas que causan problemas de traducción

Several issues have been identified and discussed, and solutions proposed in the following sections:

These are usually noticed after the first markup, and it may be necessary to re-arrange spacing and/or structure to avoid the problems.

Almost finished

  • In the summary field at the bottom, enter that you are doing a markup edit.
  • Use Preview and read through the whole of your work. If you are satisfied, save the page.
  • Use this page to request release - you can add the URL of the page you have edited. Pasting your link there tells us that you believe the page to be ready for translators to work with. We will scan it, and if satisfied we will enable it for translation.