Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Jak pliki w formacie Markdown są przetwarzane przez Wordfast Pro, Trados Studio 2022 i Phrase

Wprowadzenie

Plik ten powstał do sprawdzenia, jak trzy programy wspomagające tłumaczenie (ang. Computer-Aided Translation; CAT) — Wordfast Pro, Trados Studio 2022 i Phrase — odczytują pliki w formacie Markdown.

Czym jest CAT?

Oprogramowanie wspomagające tłumaczenie (ang. Computer-Aided Translation, zwane powszechnie jako CAT) to program, który pomaga tłumaczom tłumaczyć różnego rodzaju pliki, w tym pliki w formacie Markdown – *.md.

Istnieje wiele różnych programów typu CAT. Trzy z nich to Wordfast Pro, Trados Studio i Phrase.

Dlaczego jest to ważne?

Pliki Markdown mają nietypowy rodzaj formatowania. Składnia dla pogrubienia może wyglądać na przykład tak: __bold__. Powstaje pytanie: Czy program CAT będzie wiedzieć, który symbol jest elementem składnik Markdown, a który został użyty jako część tekstu?

By utrudnić sprawę, w pliku testowym znajduje się również kilka znaczników języka HTML, by sprawdzić, jak są one odczytywane w połączeniu ze składnią Markdown.

Wkrótce się o tym przekonamy.

Składnia Markdown

Informacje ogólne

Sprawdzimy następującą składnię Markdown:

  1. Składnia podstawowa:
    1. Nagłówek
    2. Pogrubienie
    3. Kursywa
    4. Przekreślenie
    5. Lista uporządkowana
    6. Lista nieuporządkowana
  2. Odniesienia:
    1. Odniesienia do rozdziałów z nagłówkami
    2. Odniesienia do plików
    3. Odniesienia do plików graficznych
    4. Odniesienia do stron www
    5. Odniesienia do materiałów wideo na YouTube
  3. Cytowanie:
    1. Cytat blokowy
    2. Wiersz kodu
    3. Blok kodu
  4. Składnia rozszerzona:
    1. Tabele
    2. Definicja
    3. Lista zadań
    4. Emoji
    5. Wyróżnienie
    6. Indeks dolny
    7. Indeks górny
    8. Przypisy
    9. Ignorowanie formatowania Markdown
    10. Pomijane komentarze

Pozwoli to sprawdzić, które elementy składni Markdown są — lub nie są — odczytywane przez trzy programy CAT:

  • Wordfast Pro 8
  • Trados Studio 2022
  • Phrase

składnia-podstawowa

Rozdział ten dotyczy podstawowej składni Markdown.

Nagłówek

W tekście użyto trzech rodzajów nagłówków.

Składnia:

# Header 1
## Header 2
### Header 3

Pogrubienie

Ten tekst jest pogrubiony. Ten tekst jest pogrubiony.

Składnia:

  • **This text is in bold.**
  • __This text is in bold.__

Kursywa

Ten tekst jest napisany kursywą. Ten tekst jest napisany kursywą.

Składnia:

  • *This text is in italic.*
  • _This text is in italic._

Przekreślenie

Ten tekst jest przekreślony.

Składnia: ~~This text is in strikethrough.~~

Lista uporządkowana

Oto przykład listy uporządkowanej:

  1. Pozycja 1
  2. Pozycja 2
  3. Pozycja 3
    1. Podpozycja 3.1
    2. Podpozycja 3.2

Składnia:

1. Item 1
2. Item 2
3. Item 3
   1. Subitem 3.1
   2. Subitem 3.2

Lista nieuporządkowana

Oto przykład listy nieuporządkowanej:

  • Pozycja 1
  • Pozycja 2
  • Pozycja 3
    • Podpozycja 3
    • Podpozycja 3

Składnia:

- Item 1
- Item 2
- Item 3
  - Subitem 3
  - Subitem 3

Połączenie składni podstawowej

  1. Punkt z bardzo ważnym tekstem
    • this **simply ~~*wrong*~~**
    • to jest również bardzo ważne
  2. Kolejne połączenie pogrubienia i kursywy
    1. ~~this is *__bold__ but folly*, so I crossed it out~~

Składnia:

1. *Item with **very important** text*
   - this **simply ~~*wrong*~~**
   - this is __very _important___ as well
2. Another _**combination** of __bold__ and italic_
   1. ~~this is *__bold__ but folly*, so I crossed it out~~

Odniesienia

Tutaj sprawdzimy, jak różnego rodzaju odniesienia są interpretowane przez Wordfast Pro, Trados Studio 2022 i Phrase.

Odniesienia do rozdziałów z nagłówkami

Odniesienie do rozdziału Pogrubienie znajduje się tutaj.

Odniesienia do plików

Odniesienie do pliku Markdown w repozytorium znajduje się tutaj.

Odniesienia do plików graficznych

  1. Odniesienie do pliku graficznego w repozytorium znajduje się tutaj.

  2. Odniesienie do wyświetlanego pliku graficznego w repozytorium znajduje się tutaj:

    Rekin

  3. Odniesienie do wyświetlanego pliku graficznego znajdującego się w internecie:

    Cieszyn

Odniesienia do stron www

Odniesienie do mojej strony Translatorion.com znajduje się tutaj.

Odniesienia do materiałów wideo na YouTube

Odniesienie do zagnieżdżonego materiału wideo Davida Bowie w serwisie YouTube znajduje się tutaj:

Jestem DJ-em.

Odnośniki z tekstem podpisu

Poniżej znajduje się kilka przykładów odnośników z tekstem podpisu.

  1. Odniesienie do rozdziału Pogrubienie z tekstem podpisu znajduje się tutaj.
  2. Odniesienie do wyświetlanego pliku graficznego w repozytorium z wyświetlanym tekstem podpisu znajduje się tutaj:

Rekin

  1. Odniesienie do mojej strony Translatorion.com znajduje się tutaj.

Składnia dotycząca odniesień

Składnia dotycząca odniesień — przykłady:

  1. [**Bold** is here](#bold)
  2. ![Shark](images/IMG_20200401_210429.jpg "A Technical Writer Shark")
  3. [![I am a DJ](http://img.youtube.com/vi/MRRmU_pOXnk/0.jpg)](http://www.youtube.com/watch?v=MRRmU_pOXnk "I am what I play")

Cytowanie

Rozdział ten przedstawia różne sposoby cytowania tekstu lub kodu.

Cytat blokowy

Oto przykład cytatu.

Ten cytat znajduje się wewnątrz cytatu.

wewnątrz cytatu

Ten cytat nie również obejmuje podstawową składnię i odniesienie.

— Konfuzjusz Składnia:

This is an example of a quote.

> This quote is [inside a quote](https://en.wikipedia.org/wiki/A_Dream_Within_a_Dream "Inception before it was cool").
> >![inside a quote](./images/deeper.jpg "Deep")

This quote ~~doesn't~~ *also* include*s* __basic syntax__ and a [*link*](https://en.wikipedia.org/wiki/Link,_West_Virginia).

— *Confusius*

Wiersz kodu

Oto przykład zdania z wierszem kodem tekstu w **bold** and _italic_.

Składnia:

`**bold** and _italic_`

Blok kodu

Oto przykład bloku kodu ze składnią Markdown:

1. __Bold__
2. *Italic*
   1. ~~Strikethrough~~
3. > Quotation:
   > - unordered list
4. Link [to a very wise person](https://en.wikipedia.org/wiki/Arthur_Schopenhauer)

Oto przykład bloku kodu ze składnią JavaScript:

// This is the code I found somewhere and adapted to another project.
var interval;

function countdown() {
  clearInterval(interval);
  interval = setInterval( function() {
      var timer = $('.js-timeout').html();
      timer = timer.split(':');
      var minutes = timer[0];
      var seconds = timer[1];
      seconds -= 1;
      if (minutes < 0) return;
      else if (seconds < 0 && minutes != 0) {
          minutes -= 0;
          seconds = 40;
      }
      else if (seconds < 10 && length.seconds != 2) seconds = '0' + seconds;

      $('.js-timeout').html(minutes + ':' + seconds);

      if (minutes == 0 && seconds == 0) clearInterval(interval);
  }, 1000);
}

$('#js-startTimer').click(function () {
  $('.js-timeout').text("00:40");
  countdown();
});

$('#js-resetTimer').click(function () {
  $('.js-timeout').text("00:40");
  clearInterval(interval);
});

Składnia (fragment): ` js // This is the code I found somewhere and adapted to another project. var interval; `

Składnia rozszerzona

Rozdział ten dotyczy rozszerzonej składni Markdown.

Tabele

Lp. Imię Nazwisko Zdjęcie Wiek
1. Jan Walezjusz Jan bez Trwogi 48
2. Filip Dobry Walezjusz Filip Dobry 70
3. Karol Walezjusz Karol Śmiały 44
4. __Maria __ Habsburg Maria Burgundzka 25

Składnia (fragment):

| No. | Name | Surname | Photo | Age |
| :--- | :---: | :---: | --- | ---: |
| 1. | [**John _the Fearless_**](https://en.wikipedia.org/wiki/John_the_Fearless) | [__Valois__](https://en.wikipedia.org/wiki/House_of_Valois) | ![John the Fearless](https://upload.wikimedia.org/wikipedia/commons/thumb/e/e8/Flemish_School_-_Lille_-_John%2C_Duke_of_Burgundy.jpg/173px-Flemish_School_-_Lille_-_John%2C_Duke_of_Burgundy.jpg "John the Fearless")|   48 |

Lista zadań

Oto przykład listy zadań:

  • Zadanie nr jeden
  • Zadanie nr dwa
  • Zadanie nr trzy
    • Podzadanie nr trzy-jeden
    • Podzadanie nr trzy-dwa
  • Zadanie nr cztery

Składnia: - [ ] task name

Emoji

Oto przykład listy emoji:

  • :wink:
  • :uk:
  • :cat:
  • :tm:
  • :aquarius:

Składnia: :wink:

Wyróżnienie

Oto przykład ==wyróżnienia== w Markdown. ==Nie wszystkie== procesory języka Markdown interpretują ten rodzaj wyróżnienia.

Składnia: ==text==.

Indeks dolny

Oto przykład ~indeksu dolnego~ w Markdown. ~Nie wszystkie~ procesory języka Markdown interpretują ten rodzaj indeksu dolnego.

Składnia: ~text~.

Indeks górny

Oto przykład ^indeksu dolnego^ w Markdown. ^Nie wszystkie^ procesory języka Markdown interpretują ten rodzaj indeksu górnego.

Składnia: ^text^.

Przypisy

Oto przykład zdania z przypisem.1

Składnia: This is a sentence with a footnote.[^1]

To jest kolejny przypis 2

Składnia: This is another footnote. [^bignote]

Ignorowanie formatowania Markdown

Krótka lista zignorowanego formatowania Markdown:

  • pogrubienie
  • kursywa
  • przekreślenie
  • *kod*

Składnia: **pogrubienie**

Pomijane komentarze

Poniżej tego zdania znajduje się komentarz pomijany przez procesory Markdown:

Składnia: <!--- Comment --->

Podsumowanie

To pod~minusowuje~ ^sumowuje^:

  • _ składnię BasicMarkdown:sweat_smile:_
  • I to wszystko jest w pliku *.md
  • To_jest___z dużą__emfazą — tojestz dużąemfazą

HTML i inne znaczniki

Informacje ogólne

Poniżej zostają sprawdzone znaczniki HTML i inne:

  1. Akapit
  2. Kod
  3. Sekcja zwijana
  4. Klawisze klawiaturowe
  5. Definicja
  6. Wyróżnienie
  7. Indeks dolny
  8. Indeks górny
  9. Połączenie znaczników i składni Markdown
  10. Czysta składnia HTML z JavaScript

Akapit

**Oto *lorem ipsum***: lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur ullamcorper ante sit amet aliquet convallis. Integer mollis urna quis velit mattis facilisis.

Vestibulum pulvinar sed eros vitae eleifend. Mauris et ligula metus. Nunc elementum vestibulum arcu quis ultricies. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia curae; Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.

Składnia: <p>Lorem ipsum</p>

==Ważne==: składnia Markdown jest ignorowana w elementach blokowych, takich jak tag <p></p> HTML.

Kod

To jest przykładowy kod:

  • <p>Kod dostępu: odrzucony</p>
  • **pogrubienie** _kursywa_

Składnia:

  • <code>\<p>Access code: Denied\</p></code>
  • <code>**bold** _italic_</code>

==Ważne==: składnia Markdown nie jest ignorowana w elementach typu span, takich jak tag <code></code> HTML.

Sekcja zwijana

Oto zwykła sekcja.

Rozwiń kolejną sekcję

*Tekst* z __różnym__ ~~formatowaniem~~. | Nr | Imię | Nazwisko || --- | --- | --- || 1. | Agnes | **Aardvark** || 2. | Burt | _Butterly_ | Bardzo [ważne odniesienie](https://youtu.be/dQw4w9WgXcQ?t=43).

Składnia (fragment):

<details><summary>Unroll another section</summary>
<p>

*Text* with __different__ ~~formatting~~.

</p>
</details>

Klawisze klawiaturowe

Użyj klawiszy W, S, A, D, aby poruszyć się postacią w grze komputerowej.

I nigdy nie dotykaj klawisza Windows :exploding_head:!

Składnia: <kbd>Windows</kbd>

Definicja

Oto przykładowa definicja.

„Definicja”:
twierdzenie, które objaśnia znaczenie słowa lub wyrażenia
opis cech i ograniczeń czegoś

Tłumaczenie za Cambridge Dictionary.

Składnia:

<dl>
"Definition":
<dt> a statement that explains the meaning of a word or phrase </dt>
<dt> a description of the features and limits of something </dt>
</dl>

Wyróżnienie

Oto przykład wyróżnienia w HTML. Nie wszystkie procesory języka Markdown interpretują ten rodzaj wyróżnienia.

Składnia: <mark>text</mark>

Indeks dolny

Oto przykład indeksu dolnego HTML. Nie wszystkie procesory języka Markdown interpretują ten rodzaj indeksu dolnego.

Składnia: <sub>text</sub>

Indeks górny

Oto przykład indeksu dolnego w HTML. Nie wszystkie procesory języka Markdown interpretują ten rodzaj indeksu górnego.

Składnia: <sup>text</sup>

Połączenie znaczników i składni Markdown

Oto połączenie różnych kluczowych elementów składni Markdown i znaczników HTML.

Składnia:

*This* is __a combination__ of <mark>various</mark> <kbd>key</kbd> <sup>components</sup> of [Markdown](https://en.wikipedia.org/wiki/Markdown) and <em>HTML</em> <code>tags</code>.

Czysta składnia HTML z JavaScript

Oto przykład tekstu HTML z dodanymi stylami.

Oto przykład zwykłego tekstu HTML wewnątrz stylu typu *div*.

Oto przykład zwykłego tekstu HTML bez żadnego stylu.

Oto przykład skryptu JavaScript, który odlicza z 40 sekund do 0.

Odliczaj: 00:40.

Składnia:

<html>
   <head>
      <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.2.1/jquery.min.js"></script>
      <style>
         .jotaro {
            background-color: #4f8866;
            padding: 30px;
            border: 5px solid #385A6B;
         }
        .wikkeda {
            font-size: 150%;
            font-family: 'Courier New', Courier, monospace;
            color: #385A6B;
            font-style: italic;
        }
    </style>
   </head>
    <body>
      <div class="jotaro">
         <p class="wikkeda">
            This is an <kbd>HTML</kbd> text with added <a href="https://www.youtube.com/watch?v=F-z6u5hFgPk">styles</a>.
         </p>
         <p>
            This is just a plain <em>HTML</em> text within <code>div</code> style.
         </p>
      </div>
      <div>
         <p>
            This is just a plain <em>HTML</em> text without any style.
         </p>
         <p>
            This is a JavaScript sample that counts down from 40 seconds to 0.
         </p>
         <p>   
            Countdown: <span class="js-timeout">00:40</span>.
         </p>
            <button id="js-startTimer">Start Countdown</button>
            <button id="js-resetTimer">Stop &amp; Reset</button>
            <script src="./timer.js"></script>
      </div>
    </body>
</html>

Podsumowanie

Oto podsumowanie połączenia znaczników HTML wewnątrz pliku *.md.

Wnioski

Mam nadzieję, że ta rozległa – ale na pewno nie wyczerpująca – lista znaczników Markdown i HTML będzie stanowić dobrą próbę dla programów Wordfast Pro, Trados Studio 2022 i Phrase.

Napisałem ten plik Markdown w Visual Studio Code, który nie wyświetla poniższych elementów w oknie podglądu:

  • wyróżnienie
  • indeks dolny
  • indeks górny
  • przypisy
  • sekcja zwijana
  • definicja
  • JavaScript

Ponadto nie wszystkie znaczniki Markdown lub HTML wyświetlają się w podglądzie Github.

Źródła

  1. Markdownguide.org
  2. Klawisze klawiaturowe
  3. Sekcje zwijane
  4. Daring Fireball

  1. Informacje dodatkowe ↩

  2. Jeszcze więcej informacji dodatkowych ↩