Edit Markup/fi: Difference between revisions

From KDE TechBase
No edit summary
(Updating to match new version of source page)
 
(6 intermediate revisions by 3 users not shown)
Line 2: Line 2:
== Käytettävissä olevat työkalut ==
== Käytettävissä olevat työkalut ==


* [[Special:MyLanguage/Typographical_Guidelines]] standardisoi kotoistamisessa käytettävät markup-merkinnät, joko virallisia käsikirjoja varten (DocBook) tai muille kielille. Viittaa tähän taajaan, koska markup-merkkejä määritellään uudelleen täsmäämään kotoistajien tarpeita.
* [[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.


== Työnkulku vaihe 1 ==
== Työnkulku vaihe 1 ==
Line 14: Line 14:
* ASCII-hymiöt aiheuttavat pulmia ja ne on poistettava.  Ne voidaan korvata pienikokoisilla (11px?) oxygen-kuvakkeilla.  Monia muita on saatavilla Wikimedia Commons -sivustolta - lisätiedot lisätään tänne.
* ASCII-hymiöt aiheuttavat pulmia ja ne on poistettava.  Ne voidaan korvata pienikokoisilla (11px?) oxygen-kuvakkeilla.  Monia muita on saatavilla Wikimedia Commons -sivustolta - lisätiedot lisätään tänne.


* Muotoa <nowiki>[[Kotoistamistyökulku]]</nowiki> olevat sisäiset linkit olisi muokattavat täydelliseen muotoon, jotka näyttävät linkin, sitten näkyvän tekstin, kuten <nowiki>[[Special:myLanguage/Translation_Workflow|Kotoistamistyökulku]]</nowiki>
* Muotoa <nowiki>[[Kotoistamistyökulku]]</nowiki> olevat sisäiset linkit olisi muokattava täydelliseen muotoon, jotka näyttävät linkin, sitten näkyvän tekstin, kuten <nowiki>[[Special:myLanguage/Translation_Workflow|Kotoistamistyökulku]]</nowiki>


* Syöttötekstin näyttämiseen on käytetty monia tyylejä, mukaan lukien <nowiki><code>, <pre></nowiki> ja taulukot ja laatikot. Käyttäjän syötteeksi tarkoitetun tekstin tulisi käyttää Input-mallinnetta, <nowiki>{{Input|1=syöteteksti (voi olla useita rivejä tai yksi rivi)}}</nowiki>. Voit yhä käyttää <nowiki><code></nowiki> hyvin lyhyelle syötteelle, jos et halua tekstin esiintyvän usealla rivillä.  
* Syöttötekstin näyttämiseen on käytetty monia tyylejä, mukaan lukien <nowiki><code>, <pre></nowiki> ja taulukot ja laatikot. Käyttäjän syötteeksi tarkoitetun tekstin tulisi käyttää Input-mallinnetta, <nowiki>{{Input|1=syöteteksti (voi olla useita rivejä tai yksi rivi)}}</nowiki>. Voit yhä käyttää <nowiki><code></nowiki> hyvin lyhyelle syötteelle, jos et halua tekstin esiintyvän usealla rivillä.  
Line 32: Line 32:
=== Merkitään linkit kotoistamiseen ===
=== Merkitään linkit kotoistamiseen ===


* Yksittäisen linkin, sellaisen kuin sovelluksen nimi kohteessa Applications/Internet, pitäisi käyttää muotoa <nowiki>[[Special:myLanguage/Ark|<translate>Ark</translate>]]</nowiki>
* Yksittäisen linkin, sellaisen kuin sovelluksen nimi kohteessa Applications/Internet, pitäisi käyttää muotoa <nowiki>[[Special:myLanguage/Ark|&lt;translate>Ark&lt;/translate>]]</nowiki>
* Siellä missä linkki on lauseen sisällä, koko linkki pitäisi pitää kotoistettavan viestin sisällä.
* Siellä missä linkki on lauseen sisällä, koko linkki pitäisi pitää kotoistettavan viestin sisällä.


Line 41: Line 41:
* Kohtele valikkosarjoja samalla tavalla käyttäen <nowiki><menuchoice></nowiki> -tagitunnistetta, esim.: <menuchoice>System Settings -> Account Details -> Social Desktop</menuchoice>.  Huomaa, että erotin on (välilyönti)->(välilyönti)
* Kohtele valikkosarjoja samalla tavalla käyttäen <nowiki><menuchoice></nowiki> -tagitunnistetta, esim.: <menuchoice>System Settings -> Account Details -> Social Desktop</menuchoice>.  Huomaa, että erotin on (välilyönti)->(välilyönti)


{{Warning|2=Varoitus|<span style="color:red">ÄLÄ KOSKAAN</span> lisää translate-lohkotagitunnisteita (niitä, jotka näyttävät seuraavilta <nowiki>< !--T:18-- ></nowiki>).  Ohjelmisto tekee kaikkien vaadittujen tagitunnisteiden käsittelyn, ja manuaaliset muutokset rikkovat järjestelmän.}}
{{Warning|2=Varoitus|1=<span style="color:red">ÄLÄ KOSKAAN</span> lisää translate-lohkotagitunnisteita (niitä, jotka näyttävät seuraavilta <nowiki>< !--T:18-- ></nowiki>).  Ohjelmisto tekee kaikkien vaadittujen tagitunnisteiden käsittelyn, ja manuaaliset muutokset rikkovat järjestelmän.}}


=== Lihavoidut ===
=== Lihavoidut ===
Line 67: Line 67:


* [[Typographical_Guidelines#Lists|Luetteloiden jakaminen luettavuuden vuoksi]]
* [[Typographical_Guidelines#Lists|Luetteloiden jakaminen luettavuuden vuoksi]]
* [[Typographical_Guidelines#Keeping_things_together|Muut "luettavuus" katkokset]]
* [[Typographical_Guidelines#Keeping_things_together|Muut "luettavuus"katkokset]]
* [[Typographical_Guidelines#Unbalanced_brackets|Sulkeet jakavat lohkoja]]
* [[Typographical_Guidelines#Unbalanced_brackets|Sulkeet jakavat lohkoja]]


Line 74: Line 74:
== Lähes valmis ==
== Lähes valmis ==


* Kirjoita lopussa olevaan yhteenvetokenttään, mitä olet tehnyt markup-muokkauksessa.
* In the summary field at the bottom, enter that you are doing a markup edit.
* Käytä <menuchoice>Esikatselu</menuchoice> ja lue koko työsi lävitseJos olet tyytyväinen, tallenna sivu.
* Use <menuchoice>Preview</menuchoice> and read through the whole of your workIf you are satisfied, save the page.
* Käytä sivupalkin linkkiä julkaisun pyytämiseen - se ottaa sivusi, kun lisäät muokkaamasi sivun verkko-osoitteenLinkkisi liittäminen sinne kertoo meille, että uskot sivun olevan valmis kotoistajien työskentelyä vartenTutkimme sitä, ja jos olemme tyytyväisiä, otamme sen mukaan kotoistamiseen.
* Use [[Special:myLanguage/ReadyForTranslation|this page]] to request release - you can add the URL of the page you have editedPasting your link there tells us that you believe the page to be ready for translators to work withWe will scan it, and if satisfied we will enable it for translation.


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

Latest revision as of 09:53, 10 February 2019

Käytettävissä olevat työkalut

  • 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.

Työnkulku vaihe 1

Vanhan markup-merkinnän korjaaminen

  • Tarkista, että jokaista lohkon tai alilohkon otsaketta seuraa tyhjä rivi.
  • Monille sivuille on asetettu useita sisennyksiä. Tämä sisällytettiin aikaisempaan mediawiki-dokumentaatioon, mutta ei ole enää hyväksyttävää, koska se aiheuttaa pulmia muiden muotojen viennissä, joten järjestele uudelleen käyttäen vain yksittäisiä sisennyksiä. Etumerkki-luettelot voivat edelleen olla sisäkkäisiä.
  • ASCII-hymiöt aiheuttavat pulmia ja ne on poistettava. Ne voidaan korvata pienikokoisilla (11px?) oxygen-kuvakkeilla. Monia muita on saatavilla Wikimedia Commons -sivustolta - lisätiedot lisätään tänne.
  • Muotoa [[Kotoistamistyökulku]] olevat sisäiset linkit olisi muokattava täydelliseen muotoon, jotka näyttävät linkin, sitten näkyvän tekstin, kuten [[Special:myLanguage/Translation_Workflow|Kotoistamistyökulku]]
  • Syöttötekstin näyttämiseen on käytetty monia tyylejä, mukaan lukien <code>, <pre> ja taulukot ja laatikot. Käyttäjän syötteeksi tarkoitetun tekstin tulisi käyttää Input-mallinnetta, {{Input|1=syöteteksti (voi olla useita rivejä tai yksi rivi)}}. Voit yhä käyttää <code> hyvin lyhyelle syötteelle, jos et halua tekstin esiintyvän usealla rivillä.
  • Pääteikkunatulosteet ja virheilmoitusviestit on samalla tavalla merkitty vaihtelevasti. Nämä tulisi korvata Output-mallinteella, {{Output|1=pääteikkunatuloste}}
  • Jokaisen sivun tulisi päättyä Category-luokkalauseeseen. Näiden on oltava standardisoituja luokkia. Luokkien nykyinen luettelo löydetään miltä tahansa kotoistajan sivulta linkitettynä tämä kielisivu
  • Varmista, että missään kappaleessa ei ole parittomia sulkeita. Jos löydät parittomia sulkeita, lisää puuttuvat sulkeet — mahdollisesti kommenteissa kuten tämä:
    <!--(--> a)
  • Luetteloissa pitäisi olla etumerkkirivien välissä tyhjä rivi. Katso kappeleita luetteloissa Etumerkilliset luettelot.
  • Taulukot pitäisi jakaa samalla tavalla niin että jokaisen rivin välissä on tyhjä rivi. Ensimmäisellä ja viimeisellä rivillä on oltava parilliset aaltosulkeet.

Vaihe 2 - Opas uuteen markup-merkintään

Merkitään linkit kotoistamiseen

  • Yksittäisen linkin, sellaisen kuin sovelluksen nimi kohteessa Applications/Internet, pitäisi käyttää muotoa [[Special:myLanguage/Ark|<translate>Ark</translate>]]
  • Siellä missä linkki on lauseen sisällä, koko linkki pitäisi pitää kotoistettavan viestin sisällä.

Erityistunnisteet

  • Tunnista kaikki näppäimistön näppäinnimet, ja tagitunnisteet, esim.: <keycap>Enter</keycap>
  • Sisällytä samanaikaisen näppäinten painallukset <keycap> -tagitunniste, esim.: Ctrl + Alt + F1. Huomaa, että erotin on (välilyönti)+(välilyönti)
  • Kohtele valikkosarjoja samalla tavalla käyttäen <menuchoice> -tagitunnistetta, esim.: System Settings -> Account Details -> Social Desktop. Huomaa, että erotin on (välilyönti)->(välilyönti)
Varoitus
ÄLÄ KOSKAAN lisää translate-lohkotagitunnisteita (niitä, jotka näyttävät seuraavilta < !--T:18-- >). Ohjelmisto tekee kaikkien vaadittujen tagitunnisteiden käsittelyn, ja manuaaliset muutokset rikkovat järjestelmän.


Lihavoidut

  • Tunnista ohjelmanimet ja merkitse ne lihavoituna, esim.: Klipper
  • Tunnista nimiöt ja nimet, joita käyttäjä ei voi muuttaa, ja merkitse ne lihavoiduiksi.
  • Poista kaikki aikaisemmat lihavoinnit, jotka on kirjoitettu aiemmin, mutta jotka eivät täsmää tähän ohjeeseen. (Katso alle sanan tai fraasin painottamisesta.)
  • Ikkunan otsikkotekstit ja kuvakkeiden nimiöt merkitään myös lihavoiduiksi.

Kursiivit

  • Kursivointia käytetään painottamiseen kuten tehdään ei-teknisessä kirjoittamisessa
  • Käytä kursiivia epätavallisen sanan tai fraasin ensimmäisessä esiintymisessä, ja jos mahdollista, linkitä se kohteeseen #Glossary tai sanakirjasanaan.
  • Kun viitataan muihin (ulkoisiin) teoksiin, otsikot kursivoidaan.

Yhdistetty lihavointi ja kursivointi

  • Tätä pitäisi käyttää ainoastaan asiayhteydessä, jossa käyttäjä on korvannut tekstiä, esim.: "Uudet osoitekirjatietueesi ovat kohteessa /home/user/share/contacts"
Vihje
Yksinkertaistettuja määrittelyjä - käyttäjät käynnistävät Ohjelmia, ohjelmat käyttävät komponentteja


Kohteet, jotka aiheuttavat kotoistamispulmia

Useat kohteet on tunnistettu ja niistä on keskusteltu, ja ehdotetut ratkaisut ovat seuraavassa kappaleessa:

Nämä havaitaan tavallisesti ensimmäisen markup-merkinnän jälkeen ja saattaa olla välttämätöntä järjestää uudelleen välit ja/tai rakenne pulmien välttämiseksi.

Lähes valmis

  • 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.