Własne szablony

Wystąpiły błędy skryptów na tej stronie. Mimo, że są one kierowane do redaktorów serwisu, można je częściowo przeglądać poniżej.

{{ MDCProjectPagesTOC() }} {{ HelpMDC() }} {{ Dopracuj() }}

Ta strona zawiera listę szablonów MediaWiki ogólnego zastosowania, stworzonych do użycia na MDC. Kompletną listę możemy znaleźć na stronie Special:Allpages filtrując strony, poprzez pobranie tylko tych z przestrzenią nazw Szablon. Uznaliśmy, że nie ma potrzeby wypisywać ich wszystkich tutaj.

Przeczytaj także Opis składni Wiki i listę klas CSS zdefiniowanych dla użytkownika.

Tworzenie hiperłączy

Szablon:anch

Szablon:anch wstawia odnośnik do kotwicy (anchor). {{anch|top}} tworzy <a href="#top">top</a> ({{ Anch("top") }}). Zauważ, że używając tego szablonu nie możesz wybrać opisu odnośnika innego niż nazwa kotwicy, ponieważ ideą tego szablonu było stworzenie w prosty sposób odniesienia do innego fragmentu w danym dokumencie.

Szablon:bug

Szablon:bug pozwala tworzyć odnośniki do błędów na bugzilla.mozilla.org poprzez użycie następującej składni: {{bug|123456}}. W tym przypadku otrzymasz: {{ Bug(123456) }}.

Szablon:enter-bug

Szablon:enter-bug lets you link to a Enter bug page on bugzilla.mozilla.org with specific product and component. For example, {{enter-bug|Core|Testing}} shows up as {{ Enter-bug("Core", "Testing") }}.

Szablon:ifmethod

Szablon:ifmethod lets you create a link to a particular method on an interface that's been created using our standard format for interface documentation. For example, {{ifmethod|nsIAutoCompleteSearch|stopSearch}} shows up as {{ Ifmethod("nsIAutoCompleteSearch", "stopSearch") }}.

Szablon:LXRSearch

Szablon:LXRSearch can be used (somewhat painlessly) to create an LXR search URL. Składnia jest następująca: {{LXRSearch|type|param|search-string|link-text}}. Parametry są używane w następujący sposób:

  • type must be one of search (a string search through source), find (a file name search), or ident (a search through token names in Mozilla source).
  • param must be one of string (for string/file name searches) or i (for token searches). If templates had some conditional power we could get away with one parameter instead of two, but they don't. An extension could probably work around this, as always.
  • search-string is whatever you'd type in the search box on LXR if you were doing the search there, except that spaces should be converted to +.
  • link-text jest tekstem dla odnośnika, który ma zostać utworzony.

Szablon:seealso_tag

Szablon:seealso_tag inserts a bullet list of articles that are tagged with the specified tag.  This makes it easy to list potentially relevant articles in a "See also" section.

Szablon:source

Szablon:source allows you to link to a Mozilla source code file without having to type a long LXR URL using this syntax: {{source|browser/Makefile.in}}. This gives you: {{ Source("browser/Makefile.in") }}. The text of the link is the path provided; if you want different text, then just provide a second parameter, like so: {{source|browser/Makefile.in|the browser/ Makefile.in}}, which produces {{ Source("browser/Makefile.in", "the browser/ Makefile.in") }}. Note that the link will be to the very latest version of the file in bleeding-edge code.

Szablon:source_cvs

Szablon:Source_cvs works just like Template:source, except it links to the CVS repository instead of the newer mozilla-central one.

Odnośniki do stron w dokumentacji

(Szablon ten nie jest zbyt często stosowany)

Zastosowanie: {{cssxref|color}}: {{ Cssxref("color") }}.

Szablon pozwoli Ci zaoszczędzić trochę pisania w sposób stardardowy: [[CSS:color|color]].

Tagging pages

These templates should be placed at the top of a page (but below the breadcrumbs). Some templates can be also used at the top of a section.

Szablon:disambig

Szablon:disambig is used on the few disambiguation pages we have.

Szablon:outdated i Szablon:NeedsTechnicalReview

This template should be used to tag pages that are known to be (or might be) horribly outdated. It's most commonly used when an old page is migrated from mozilla.org to MDC.

The template is followed by an optional parameter, which can be used to provide details. Example: {{outdated|It was last updated in 1999.}} gives you this:

{{ Outdated("It was last updated in 1999.") }}

A similar template, Szablon:NeedsTechnicalReview is for less hopeless cases when an author or an editor was unsure if something he read or wrote was technically correct. {{NeedsTechnicalReview}} results in: {{ NeedsTechnicalReview() }}

Szablon:LockedPage

Szablon:LockedPage inserts a mark bar across the page that provides an explanation for why a page is locked. There are two parameters: the first is the length of time for which the page is expected to be locked, and the second is the reason why it's locked. A link to the page's discussion page is also included in the bar. {{ LockedPage("permanently", "constant spamming") }}

Szablon:deprecated_header, non-standard_header, obsolete_header

Szablon:deprecated_header inserts a deprecated mark bar spread out across the page to discourage the use of, e.g., a function, method or property which is officially deprecated. The deprecated bar typically would be placed directly underneath the main page title (or breadcrumb navigation if available) of, e.g., a specific function, method or property specification page. Usage: {{deprecated_header}}. Result: {{ Deprecated_header() }}

Similarly, Szablon:non-standard_header and Szablon:obsolete_header can be used to mark non-standard and obsolete functionality. Usage: {{non-standard_header}} or {{obsolete_header}}. Result: {{ Non-standard_header() }} {{ Obsolete_header() }}

Templates tagging pages in the references/guides/tutorials

There are a number of templates for almost each large collection of pages (such as the DOM reference. They typically link back to the main page of the reference/guide/tutorial (this is often needed because our breadcrumbs sometimes can't do this) and put the article in the appropriate category.

E.g.: Szablon:DomRef, Szablon:CSSRef, Szablon:jsapi ref header, ... (yes, the capitalization inconsistency sucks)

Szablony ogólnego użytku

Szablon:block-title

Szablon:block-title can be used to create bolded text which visually serves as a title for a block in a page, does not appear in the auto-generated table of contents, and can act as a link target just as headings do. The syntax is: {{block-title|title}}, where title is whatever you want displayed. title also serves as the target for links to the section you are titling. Szablon:block-title is meant for use in titling {{ Anch("Szablon:sidenote") }}s, tables, images, and code blocks, particularly in places where you'll be referring to the particular item more than once or in places not close to the item itself.

Szablon:Clr

Szablon:Clr inserts a <br style="clear:both;" /> to make sure the text following it is below any floating images or other figures. Usage: {{Clr}}.

  • Please note that using this template may mess up the layout of the whole page, for example because the navigational panel in default skin is floated at the left side, so everything after {{Clr}} will also be below the navigational panel.

Szablon:Note oraz Szablon:warning

Szablon:Note inserts a specially-formatted "note" block into the article's text. This is intended to call out an interesting or important fact. It uses the "note" CSS class. Using the template instead of directly using the class allows us to make more changes to the appearance of the notes more easily in the future. Usage: {{Note|This is an important note.}}. Result: {{ Note("To jest ważna uwaga.") }}

Similarly, Szablon:warning inserts a specially-formatted "warning" block. {{warning|Danger, Will Robinson!}} results in: {{ Warning("Danger, Will Robinson!") }}

As you can see, the warning block includes a large icon and is currently used for article headings (via Szablon:outdated). You might want to use div class="warning" instead.

Szablon:ref i Szablon:note

Szablon:ref i Szablon:note can be used to implement footnotes to articles. The footnote "number" is created using {{ref|coś}}, where coś should be some suitably descriptive word for whatever's being mentioned in the footnote. Then, at the end of the document, insert the following to create a numbered list for the footnotes' information:

# {{note|something}} Blah blah, tekst dla pierwszego footnote
# {{note|something-else}} Tekst dla innego footnote
# ...

Szablon:deprecated_inline

Szablon:deprecated_inline inserts an in-line deprecated mark to discourage the use of, e.g., a function, method or property which is officially deprecated. Usage: {{deprecated_inline}}. Example:

  • Item 1
  • Item 2 {{ Deprecated_inline() }}
  • Item 3

Szablon:non-standard_inline

Szablon:non-standard_inline inserts an in-line non-standard mark to discourage the use of, e.g., a function, method, property, or attribute which has not been standardized. Usage: {{non-standard_inline}}. Example:

  • Item 1
  • Item 2 {{ Non-standard_inline() }}
  • Item 3

Szablon:obsolete_inline

Szablon:obsolete_inline inserts an in-line obsolete mark to prevent the use of e.g. a function, method or property which is officially obsolete. Użycie: {{obsolete_inline}}. Przykład:

  • Pozycja 1
  • Pozycja 2 {{ Obsolete_inline() }}
  • Pozycja 3

Szablon:Previous, Szablon:Next, i Szablon:PreviousNext

Szablon:Previous, Szablon:Next, i Szablon:PreviousNext dostarczają kontrolki nawigacji w artykułach, które są częścią odpowiadającą za porządek na MDC. Kontrolki jednokierunkowe wymagają tylko jednego parametru, którym jest lokalizacja poprzedniego lub kolejnego artykułu. Szablon PreviousNext wymaga 2 parametrów, z których pierwszy oznacza lokalizację poprzedniego artykułu, a drugi - kolejnego.

Szablon:unimplemented_inline

Szablon:unimplemented_inline inserts an in-line "unimplemented" mark to prevent the use of e.g. a function, method or property which is not yet implemented. Usage: {{unimplemented_inline}}. Example:

  • Pozycja 1
  • Pozycja 2 {{ unimplemented_inline() }}
  • Pozycja 3

Szablony informujące o wersji

Do usuniecia?

Szablon:sidenote

Due to limitations of templates in Mediawiki which prevent templates from being nested (e.g., {{sidenote|left|See also {{bug|123456}}.}}, where the end of the inner template is incorrectly parsed as the end of the outer template), this template should no longer be used. Instead, use the following:

<div class="side-note-left">...</div> <!-- for a left-floated sidebar -->
<div class="side-note-right">...</div> <!-- for a right-floated sidebar -->

Zobacz także

{{ languages( { "de": "Project:de/Spezielle_Vorlagen", "en": "Project:en/Custom_Templates", "ja": "Project:ja/Custom_Templates", "pt": "Project:pt/Predefini\u00e7\u00f5es_personalizadas" } ) }}

Autorzy i etykiety dokumentu

Autorzy tej strony: Ptak82, DeyV, Bedi, Dria, Diablownik
Ostatnia aktualizacja: Bedi,