MDC:Opis składni Wiki
z Mozilla Developer Center, polskiego centrum programistów Mozilli.
- Jak pomóc: Treść
- Poradnik
- Na początek
- Przewodnik dla edytorów
- Poradnik nazywania stron
- Strony ujednoznaczniające
- Prawa autorskie i licencje
- Dokumentacja
- Opis składni Wiki
- Własne klasy CSS
- Własne szablony
- Rozszerzenia MediaWiki
- Zewnętrzne przekierowania
- Dodatkowa pomoc
- Edycja/przegląd listy
- Słownik
- FAQ
- Społeczność MDC
- Lista kontaktów
Poniższy dokument zawiera zbiór zasad i metod formatowania tekstu na wiki MDC. Oczywiście jest to coś, co zmienia się wraz z upływem czasu, dlatego są to jedynie zalecenia edycyjne, a nie surowe zasady, których należy się bezwzględnie trzymać.
Jeśli musisz, nie wahaj się używać metod niezgodnych z tym przewodnikiem - nikt nie będzie miał Ci tego za złe. Pamiętaj jednak, aby trzymać się zasad tutaj zawartych tak bardzo, jak tylko to możliwe.
Jeśli masz pytania dotyczące tego przewodnika, skontaktuj się z Erikiem Shepherdem lub zapytaj na #devmo - kanale IRC irc://irc.mozilla.org.
Spis treści |
[edytuj] Podstawy
[edytuj] Sekcje, akapity, nowe linie
| Rezultat: | Znacznik: |
| Sekcje: | |
|
Sekcja Pod-sekcja Pod-pod-sekcja Pod-pod-pod-sekcja Jeśli Twój dokument potrzebuje więcej niż cztery poziomy sekcji, zaleca się, aby przerwać dalsze ich tworzenie i rozdzielić na kilka mniejszych, połączonych ze sobą stron. |
= Sekcja =
== Pod-sekcja ==
== Odnośniki ==
{| class="fullwidth-table"
|-
|class="header" width="50%"|Rezultat:
|class="header" width="50%"|Znaczniki:
|-
|-
|class="header" colspan="2"|Odnośniki wewnętrzne:
|-
|-
|
'''Prosty odnośnik wewnętrzny odsyłający do następnej strony...'''
1 kwietnia jest [[Prima Aprilis]].
|
<pre>
1 kwietnia jest [[Prima Aprilis]].
|
|
Odnośnik wewnętrzny, gdzie tytuł strony docelowej jest inny niż tekst linku... 1 kwietnia urodziny obchodzi Dria. |
[[Prima Aprilis|1 kwietnia]] urodziny obchodzi Dria. |
|
Odnośnik wewnętrzny do określonej sekcji kolejnej strony... |
[[Prima Aprilis#Urodziny|Kto obchodzi urodziny 1 kwietnia]]. |
|
Końcówki są dołączane do odnośnika... W kwietniu kwitną krokusy. |
W kwietniu kwitną [[krokus]]y. |
|
Dodanie podpisu, który prowadzi do strony użytkownika... lub Dria 13:39, 15 Mar 2005 (EST) |
~~~ lub ~~~~ |
| Odnośniki zewnętrzne: | |
|
Prosty odnośnik URL... |
http://www.mozilla.org |
|
Odnośnik zewnętrzny z wyświetloną inną nazwą... |
[http://www.mozilla.org Mozilla Project] |
|
Odnośnik do odpowiedniego błędu na Bugzilli... |
{{bug|322603}}
|
| Odnośniki językowe | |
|
Odnośnik do stron wiki Mozilli nt. Firefoksa |
[[wikimo:Firefox|Firefox]] |
|
Odnośnik do artykułu o Firefoksie na Wikipedii |
[[wikipedia:Mozilla|Mozilla]] |
[edytuj] Formatowanie tekstu
| Rezultat: | Znacznik: |
| Formatowanie tekstu: | |
|
kursywa lub wyróżnienie |
''kursywa'' lub ''wyróżnienie'' |
|
pogrubienie lub wytłuszczenie |
'''pogrubienie''' lub '''wytłuszczenie''' |
|
pogrubiona kursywa lub wyróżnienie pogrubienia |
'''''pogrubiona kursywa''''' lub '''''wyróżnienie pogrubienia''''' |
|
Zastosowanie |
Zastosowanie <code>kodu "in-line"</code> jako przykładu. |
Jak do kodu
dodać
bloki.
|
<pre>
Jak do kodu
dodać
bloki.
</pre>
|
Cytaty - to jest cytat. |
<blockquote> Cytaty - to jest cytat. </blockquote> |
|
Mały tekst. |
<small>Mały tekst.</small> |
|
Duży tekst. |
<big>Duży tekst.</big> |
|
|
<strike>Przekreślenie.</strike> |
|
Podkreślenie. |
<u>Podkreślenie.</u> |
|
Superskrypt. |
<sup>Super</sup>skrypt. |
|
Subskrypt. |
<sub>Sub</sub>skrypt. |
[edytuj] Listy
| Rezultat: | Znacznik: |
| Listy punktowe: | |
Wygląd punktów listy oraz jej wcięć może zostać zmieniony za pomocą CSS. |
* Poradniki ** Dokumentacje ** Przewodniki * Artykuły ** Przewodniki *** JavaScript *** HTML *** CSS ** Porady & Sztuczki * FAQ |
| Lista numeryczna | |
Numeracja listy oraz jej styl mogą zostać zmienione za pomocą CSS. |
# Poradniki ## Dokumentacje ## Przewodnik # Artykuły ## Poradniki ### JavaScript ### HTML ### CSS ## Porady & Sztuczki # FAQ |
[edytuj] Odnośniki
| Rezultat: | Znaczniki: |
| Odnośniki wewnętrzne: | |
|
Prosty odnośnik wewnętrzny odsyłający do następnej strony... 1 kwietnia jest Prima Aprilis. |
1 kwietnia jest [[Prima Aprilis]]. |
|
Odnośnik wewnętrzny, gdzie tytuł strony docelowej jest inny niż tekst linku... 1 kwietnia urodziny obchodzi Dria. |
[[Prima Aprilis|1 kwietnia]] urodziny obchodzi Dria. |
|
Odnośnik wewnętrzny do określonej sekcji kolejnej strony... |
[[Prima Aprilis#Urodziny|Kto obchodzi urodziny 1 kwietnia]]. |
|
Końcówki są dołączane do odnośnika... W kwietniu kwitną krokusy. |
W kwietniu kwitną [[krokus]]y. |
|
Dodanie podpisu, który prowadzi do strony użytkownika... lub Dria 13:39, 15 Mar 2005 (EST) |
~~~ lub ~~~~ |
| Odnośniki zewnętrzne: | |
|
Prosty odnośnik URL... |
http://www.mozilla.org |
|
Odnośnik zewnętrzny z wyświetloną inną nazwą... |
[http://www.mozilla.org Mozilla Project] |
|
Odnośnik do odpowiedniego błędu na Bugzilli... |
{{bug|322603}}
|
| Odnośniki językowe | |
|
TBD |
TBD |
[edytuj] Komentarze
| Rezultat | Znacznik |
|
Poniższy komentarz nie zostanie wyświetlony. Zupełnie jak komentarz w języku HTML. Użyj komentarzy do zapisu notatek lub instrukcji dla innych autorów dokumentu, edytorów lub odwiedzających daną stronę. |
Poniższy komentarz nie zostanie wyświetlony. Zupełnie jak komentarz w języku HTML. Użyj komentarzy do zapisu notatek lub instrukcji dla innych autorów dokumentu, edytorów lub odwiedzających daną stronę. <!--- Tutaj jest komentarz. ---> |
[edytuj] Zaawansowane znaczniki
[edytuj] Tabele
| Rezultat: | Znacznik: | ||||
| Znacznik tabeli: | |||||
|
Aby stworzyć tabelę na wiki możesz użyć standardowego table z języka HTML lub użyć znacznika wiki. Znacznik tabeli wiki składa się z mniejszej ilości znaków i prawdopodobnie jest to jego jedyna większa zaleta. Używaj tego, co jest dla Ciebie wygodniejsze. | |||||
|
<table class="standard-table">
<tr>
<th>nagłówek 1</th>
<th>nagłówek 2</th>
</tr>
<tr>
<td>komórka 1</td>
<td>konórka 2</td>
</tr>
</table>
| ||||
|
{| class="standard-table"
|-
|class="header"|nagłówek 1
|class="header"|nagłówek 2
|-
|-
|komórki 1
|komórki 2
|-
|}
| ||||
[edytuj] Grafika
| Rezultat: | Znacznik: |
| Grafika: | |
|
Obrazek liniowy...
|
[[Grafika:Firefox-logo.png]] |
|
Obrazek liniowy wraz z tekstem alternatywnym...
|
[[Grafika:Firefox-logo.png|Firefox - przeglądaj sieć.]] |
|
Miniaturka obrazka wraz z tekstem alternatywnym...
|
[[Grafika:Flower.jpg|thumb|Zdjęcie makro.]] |
|
Link do obrazka... |
[[media:Flower.jpg|Zdjęcie makro.]] |
[edytuj] Kategorie
Każda strona wiki powinna znajdować się w co najmniej jednej kategorii MediaWiki. Aby dodać kategorię do strony, użyj na stronie następującej składni:
[[Kategoria:NazwaKategorii]]
Odnośniki do kategorii umieszczamy na dole strony, za jej zawartością. Dodaj tyle odnośników kategorii, ile jest aktualnie potrzebnych. Na przykład: w przewodniku o Venkmanie powinniśmy dodać kategorie: "Venkman", "Narzędzia", i "Przewodnik".
Wszystkie kategorie, których używamy, powinny być umieszczone w Kategoria:Wszystkie kategorie.
[edytuj] Referencje do innych wersji językowych
Strona zyskuje na wartości, gdy na stronie pojawiają referencje do innych wersji językowych. Na przykład, aby wstawić na tę stronę referencję do wersji artykułu w języku portugalskim, musimy dodać poniższy fragment kodu na samym końcu strony:
[[pt:Referência de Marcação Wiki]]
Innymi słowy: dodajemy wewnętrzny odnośnik do określonej strony, wraz z prefiksem, który określa jej język.
Referencje do stron innych w językach można stosować również na stronach kategorii.
[edytuj] Ignorowanie składni wiki
Jeśli chcesz, aby parser częściowo ignorował znaczniki wiki, należy je zamknąć po prostu w tagu "nowiki" jak w przykładzie:
<nowiki>'''te znaczniki wiki nie będą interpretowane'''</nowiki>
'''te znaczniki wiki nie będą interpretowane'''
[edytuj] HTML w Wikitext
Następujące znaczniki są aktualnie dostępne w znacznikach wiki:
[edytuj] Znaki specjalne
| Rezultat: | Znacznik: |
|
Umlauty i akcenty: è é ê ë ì í À Á Â Ã Ä Å |
è é ê ë ì í À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü ß à á â ã ä å æ ç è é ê ë ì í î ï ñ ò ó ô œ õ ö ø ù ú û ü ÿ |
|
Punktowe: |
¿ ¡ « » § ¶ † ‡ • - – — |
|
Symbole komercyjne: |
™ © ® ¢ € ¥ £ ¤ |
| Znaki greckie: α β γ δ ε ζ |
α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σ ς τ υ φ χ ψ ω Γ Δ Θ Λ Ξ Π Σ Φ Ψ Ω |
|
Znaki matematyczne: |
∫ ∑ ∏ √ − ± ∞ ≈ ∝ ≡ ≠ ≤ ≥ × · ÷ ∂ ′ ″ ∇ ‰ ° ∴ ℵ ø ∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇ ¬ ∧ ∨ ∃ ∀ ⇒ ⇔ → ↔ ↑ |
x2 ≥ 0 true.
|
<i>x</i><sup>2</sup> ≥ 0 true. |
[edytuj] Rozszerzenia użytkownika - Firefox
- Rozszerzenie Firefoksa - Wikipedia, które dodaje pasek narzędziowy tag-helper. Jest przydatne i prawdopodobnie działa poprawnie w wersji 1.0.3 Firefoksa.
- Wsparcie zewnętrznego edytora tekstowego dla Firefoksa i MediaWiki.
[edytuj] Inne dokumentacje
[edytuj] Szczegóły MDC
- Własne klasy CSS definiowane dla wszystkich stron MDC.
- Szablony Mediawiki, stworzone do wykorzystania na stronach MDC.
- Prawa autorskie w MDC:
- Jeśli nie jesteś pewien jak nazwać stronę, zobacz poradnik nazywania stron.
- MDC:Ujednoznacznienie