To jest stara wersja strony!
Spis treści
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.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.
- Patrz również: Rozwój szablonów
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) |