DokuWiki

It's better when it's simple

Narzędzia użytkownika

Narzędzia witryny


pl:devel:css

To jest stara wersja strony!


Arkusze stylów CSS

Większość sposobu wyświetlania przez DokuWiki może być definiowana za pomocą arkuszy stylów CSS. Samo DokuWiki definiuje tylko kilka niewielkich stylów. Reszta definicji CSS pochodzi od użytych szablonów i wtyczek.

Wszystkie pliki CSS są pobierane za pośrednictwem jednego dyspozytora w lib/exe/css.php, który obsługuje również buforowanie, zastępowanie wzorców i optymalizację. Wczytywanie arkuszy stylów oprócz innych czynności wykonywane jest wewnąrez funkcji tpl_metaheaders(), zatem nie zapomnij umieścić jej w swoim szablonie.

Tryby arkuszów stylów

Jest pięć typów trybów arkusza stylu:

  • screen: Używany do wyświetlania stron w przeglądarce
  • print: Definicje stąd zostaną użyte do drukowania stron
  • all: Stosowane we wszystkich trybach wyświetlania
  • rtl: Definicje w plikach rtl zostaną wczytane dodatkowo gdy jest użyty język pisany z prawej do lewej
  • feed: Stosowane podczas wyświetlania stopki

Arkusze stylów DokuWiki

DokuWiki wczytuje swoje arkusze z 4 źródeł, które ładowane są w następującej kolejności (Arkusze RTL są dodawane na końcu każdego kroku):

1.Podstawowe arkusze stylów

Te arkusze znajdują się w /lib/styles. Określają one stylizację podstawowych elementów, jak wygląd komunikatów błędów.

2.Style wtyczek

Wtyczki mogą określać własne definicje przy użyciu następujących plików:

Tryb Plik CSS
screen style.css or screen.css
print print.css
all all.css
rtl rtl.css
feed feed.css

Aby dostosować się do zestawu kolorów szablonu, autorzy wtyczek powinni używać gwarantowanych zastępczych oznaczeń kolorów.

:!: Arkusze stylów z wtyczki wczytywane są nawet, jeśli wtyczka nie jest używana (nie jest jednak, jeśli wtyczka jest wyłączona).

:!: Style zdefiniowane tutaj powinny mogą powodować konflikty. Zatem uważaj pisząc wtyczkę. Jeśli to możliwe, dodaj przedrostek do własnych stylów by nie powodowały one konfliktów.

3.Style szablonów

Arkusze stylów szablonu są ładowane z wybranego folderu szablonu. DokuWiki odczytuje style.ini znajdujący się w folderze i wczytuje wszystkie CSS wymienione w tym pliku. Wczytywanie wykonywane jest zgodnie z aktualnym trybem.

Dodatkowo s tym pliku style.ini definiowane są zastąpienia.

4.Style użytkownika

Dodatkowe style, niezależnie od użytego szablonu moga być zdefiniowane przez administratora wiki poprzez utworzenie następujących plików CSS w folderze konfiguracyjnym wiki (conf/ w niepoprawianych wiki):

Plik CSS w Anteaterze Plik CSS przed i po Anteaterze1) Kiedy używane
conf/userstyle.css conf/userstyle.css Stosowane w trybie ekranowym
conf/printstyle.css conf/userprint.css Stosowane podczas wydruku strony
conf/rtlstyle.css develonly conf/userrtl.css Stosowane gdy używany język spisany z prawej do lewej
conf/feedstyle.css conf/userfeed.css Stosowane w wyświetlaniu stopki
conf/allstyle.css conf/userall.css Stosowane we wszystkich trybach wyświetlania

Jest to użyteczne do nadpisywania małych części stylów szablonu lub wtyczek bez borykania się z problemami korekt po aktualizacji.

Using IDs

When you use custom IDs in your template for assigning styles, be sure that the ID does not conflict with an existing ID. In particular, be sure that it won’t conflict with the IDs automatically assigned to section headers. The easiest way to ensure this is to use two adjacent underscores (__) in your ID. Because section IDs are always valid pagenames, they will never contain adjacent underscores.

In plugins use <pluginname>__<id>. For example 'searchindexplugin__buttonfield'

Style.ini

The style.ini is a ini file. It has two sections :

[stylesheets]

This part defines which CSS files are loaded. Each line is defined as follow :

cssfile.css = mode

cssfile.css is your file name, and mode is the mode to which it applies.

[replacements]

DokuWiki's CSS dispatcher is able to replace placeholders in the loaded stylesheets which are configured through the [replacements] section in the templates style.ini. This is especially useful for defining a color scheme once and reuse these colors in all files. Adjusting the colors later then is simply a matter of changing the ini file.

Gwarantowane zastępcze oznaczenia kolorów

The following placeholders are the only ones that are safe to be used by plugins.

placeholder variable meaning value in default tpl name before 2006-08-05
__background__ main background color #fff __white__
__background_alt__ alternative background color #dee7ec __medium__
__background_neu__ neutral background color #f5f5f5 __lightgray__
__border__ border color #8cacbb __dark__
__text__ main text color #000 __black__
__text_alt__ alternative text color #638c9c __darker__
__text_neu__ neutral text color #666 __darkgray__

From 2006-08-05 on they have been renamed to be more semantically correct. Plugins and templates making use of the pattern replacement which are older than this might not yet have adopted these variables, but are advised to do so.

Other color placeholders used by the default template

These additional placeholders are used in the default templates. Other templates might use them as well, but are not necessarily obliged to do so.

placeholder variable meaning value in default tpl name before 2006-08-05
__background_other__ other background colour #f7f9fa __lighter__
__text_other__ other text colour #ccc __mediumgray__
(none, omitted) - #eef3f8 __light__
__extern__ link colour #436976 (unchanged)
__existing__ link colour of existing internal links #090 (unchanged)
__missing__ link colour of missing internal links #f30 (unchanged)
__highlight__ colour of highlighted search snippets #ff9 (unchanged)
1)
przywrócone po 2011-02-26
pl/devel/css.1325638165.txt.gz · ostatnio zmienione: 2012-01-04 01:49 przez 78.8.126.5

Wszystkie treści w tym wiki, którym nie przyporządkowano licencji, podlegają licencji: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki