Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

rewrite README files

  • Loading branch information...
commit dad9536bb1e3cab3138895fd873b4a7578788c41 1 parent d8a28de
@andreashaerter andreashaerter authored
Showing with 417 additions and 417 deletions.
  1. +284 −276 README
  2. +131 −139 README-de
  3. +1 −1  style.ini
  4. +1 −1  user/rtl.css
View
560 README
@@ -1,276 +1,284 @@
-Title: README of the vector template for DokuWiki
-Creation date: 2010-05-29
-Last Update: 2011-11-24
-Author: Andreas Haerter <development [ät] andreas-haerter.com>
-Web: <http://andreas-haerter.com/projects/dokuwiki-template-vector>
- <http://www.dokuwiki.org/template:vector>
-
-
-
-PLEASE NOTE: I am NO native English speaker. If you find any errors please let
- me know (e.g. by mail). Otherwise, my English is not getting better
- (as desired by myself). Thank you! -- Andreas Haerter
-
-
-
-I. Using/Installing the template
- Using "vector" is simple and works just as described at
- <http://www.dokuwiki.org/template>: extract the downloaded archive into
- your DokuWiki's "lib/tpl/" folder. Then select the template in the Config
- Manager by adjusting the template option. Done. :-)
-
- If you are updating an existing vector-installation: please have a look at
- <http://www.dokuwiki.org/template:vector>, you should find all needed
- information there.
-
- NOTE: If everything will be displayed unformatted, your PHP environment is
- probably affected by PHP bug #49692 (see bugreport at
- <http://bugs.php.net/bug.php?id=49692> for details). You may find errors
- like "syntax error, unexpected '/' in ../../lib/tpl/vector/style.ini
- on line XX" in your PHP logs when this is the case. vector provides
- a workaround for this, simply delete vector's "style.ini" to trigger the
- template to use it.
-
-
-
-II. Customizing the template
- In order to make updates of your installed "vector" template easy, follow
- these hints for customizing the template:
-
- - Place your files in "vector/user"
- The place for *all* userdefined, custom stuff is "vector/user".
- Reason: this folder will not be touched on updates. Therefore you may delete
- everything except "vector/user" and copy all new files into "vector/" to
- update without loosing your changes. Do not forget to empty your browser's
- cache afterwards.
-
- - Own logo
- If you want to replace the default logo showed in the upper left, simply
- create a "logo.[png|gif|jpg]" in "vector/user". The template recognizes
- the file automatically and will use it instead of the default logo.
- Do not forget to empty your browser's cache afterwards.
-
- - Own favicon
- If you want to replace the default favicon, simply create a "favicon.ico" in
- "vector/user". The template recognizes the file automatically and will use
- it instead of the default one. Do not forget to empty your browser's cache
- afterwards. By the way: you might find the following online tool useful:
- <http://tools.dynamicdrive.com/favicon/>
- Note: "favicon.png" is also possible but not recommended (cause it is not
- supported by most MSIE versions).
-
- - Own CSS
- To apply additional CSS rules, edit "vector/user/screen.css" (influences
- normal layout) and/or "vector/user/print.css" (influences print layout)
- and/or "vector/user/rtl.css" (influences "right-to-left" languages like
- hebrew). These files will be included automatically (as the last ones for
- the relevant media, therefore you are able to overrule existing styles). Do
- not forget to empty your browser's cache afterwards.
-
- - Own JavaScript
- To load additional JavaScript, edit "vector/user/user.js". Do not forget
- to empty your browser's cache afterwards.
- ATTENTION: Do not forget to activate the template option
- "vector_loaduserjs" (->"Load 'vector/user/user.js'?") in the
- DokuWiki Config Manager!
-
- - Own CSS, language specific
- To apply additional CSS rules only for a specific language, edit/create
- "vector/lang/<your-language>/style.css". This file will be included
- automatically if DokuWiki runs/shows a page in the language of choice (as
- the last one, therefore you are able to overrule existing styles). Do
- not forget to empty your browser's cache afterwards.
-
- - Own tabs
- To apply own tabs, have a look at "vector/user/tabs.php". Don't worry:
- you will find some examples how to define the tabs. If you still have
- questions after playing with the examples, search
- <http://dokuwiki.org/template:vector> and/or the DokuWiki Forum at
- <http://forum.dokuwiki.org> and/or ask the community if you can't get it
- work.
- If "vector/user/tabs.php" does not exist, simply copy it out of the
- current actual installation archive.
-
- - Own footer buttons
- To apply own buttons/graphics in the footer (-> these small 80x15 pics),
- have a look at "vector/user/buttons.php". Don't worry: you will find some
- examples how to define the buttons. If you still have questions after
- playing with the examples, search <http://dokuwiki.org/template:vector>
- and/or the DokuWiki Forum at <http://forum.dokuwiki.org> and/or ask the
- community if you can't get it work.
- If "vector/user/buttons.php" does not exist, simply copy it out of the
- current actual installation archive.
-
- - Own boxes
- To apply own boxes in the left column/sidebar, have a look at
- "vector/user/boxes.php". Don't worry: you will find some examples how to
- define the boxes. If you still have questions after
- playing with the examples, search <http://dokuwiki.org/template:vector>
- and/or the DokuWiki Forum at <http://forum.dokuwiki.org> and/or ask the
- community if you can't get it work.
- If "vector/user/boxes.php" does not exist, simply copy it out of the
- current actual installation archive.
-
- - Web analytics software (Piwik, Google Analytics etc.)
- Tools like Piwik and Google Analytics normally provide a small code snippet
- ("tag") which you have to include at your website to make everything work.
- If you want to use such software with this template, have a look at
- "vector/user/tracker.php". This file exists to make it easier for you.
- You don't have to deliberate where you have to copy and paste the code,
- simply do it there.
-
- - Own Apple Touch Icon
- If you want to replace the default Apple Touch Icon, simply create a
- "apple-touch-icon.png" in "vector/user". The template recognizes the file
- automatically and will use it instead of the default one. Have a look at
- Apple's developer database if you need more information ("Configuring Web
- Applications" <http://j.mp/sx3NMT>).
-
-
-
-III. Some notes about the dirs of this template
- * "vector/conf"
- Contains some configuration files (do NOT edit them!), especially
- default.php: default settings, see
- <http://www.dokuwiki.org/devel:configuration#default_settings>
- metadata.php: configuration metadata, see
- <http://www.dokuwiki.org/devel:configuration#configuration_metadata>
- * "vector/lang"
- Language files (subdir names = language code). You may copy the English
- language files and translate them if your language is missing. Simply mail
- me, Andreas Haerter, the translated files and I will include them in the
- next release :-D.
- * "vector/static"
- Static files (images, CSS, JavaScript). The interesting stuff is located
- in subdirs (as described below).
- - "3rd"
- Static files originally taken from a third party like MediaWiki or
- DokuWiki. The subdir "dokuwiki" contains files originally taken from the
- DokuWiki "default" or "starter" template. The subdir "vector" contains
- files taken from the MediaWiki "vector" skin.
- - "css"
- All non-3rd-party Cascading Style Sheets (CSS). See <http://j.mp/eq8zSo>
- for more information about how the CSS is handled.
- - "img"
- All non-3rd-party images files.
- - "js"
- All non-3rd-party JavaScript files.
- * "vector/user"
- Place for userdefined stuff. E.g. if you want to replace the default-logo,
- simply copy a logo.[png|gif|jpg] in here. See "II. Customizing the template"
- for details.
-
-
-
-IV. Other notes
- - Even if it is not required: If you like the template, think about a small
- donation (see <http://andreas-haerter.com/donate/dokuwiki-template-vector>)
- and/or a link to <http://andreas-haerter.com/projects/dokuwiki-template-vector>.
- Thanks :-).
-
- - This template follows the DokuWiki coding style (see
- <http://www.dokuwiki.org/devel:coding_style>). If you want to submit any
- patches, please respect its rules (even if you don't like it - I also don't
- love it but this simply does not matter).
-
- - Feel free to send patches or suggestions via mail (or post on
- <http://www.dokuwiki.org/template:vector>).
-
- - Please don't delete the "index.html" and ".htaccess" files for security
- reasons, even if you don't know why they are there. These files should
- prevent others from listing directory contents (a built in feature of most
- webservers) and providing additional access protection for some files. Even
- if everything should be secure without, I prefer some additional
- precautions.
-
-
-
-V. About
- "vector" is a template to offer the new MediaWiki/Wikipedia Look&Feel
- (introduced in 2010) to DokuWiki. It is a (mostly) optical port of the
- MediaWiki skin and maintained/developed by me, Andreas Haerter.
- If you have any suggestions and/or bug reports, feel free to post on
- <http://www.dokuwiki.org/template:vector>, send me an email or have a look at
- <http://andreas-haerter.com/contact>.
-
-
-
-VI. Creation transcript
- Some developers may find this interesting. Additionally, I am very oblivious
- :-P.
-
- - Downloaded the nightly MediaWiki build (cause only the SVN version is
- containing the vector skin as I'm writing this) from
- <http://toolserver.org/~vvv/mw-nightly/>.
-
- - Installed DokuWiki (Release "2009-12-25c", "Lemming") for testing purpose.
-
- - Copied all "monobook for DokuWiki" sources cause it already fits some of
- my needs regarding config options and non-layout features. Means: I used the
- source of the "monobook for DokuWiki" template as base for
- "vector for DokuWiki".
-
- - replaced "monobook" through "vector" in:
- - /conf/*
- - /lang/*
- - /bug49642.php
- - /detail.php
- - /inc_cite.php
- - /inc_detail.php
- - /inc_mediamanager.php
- - /main.php
- - /mediamanager.php
-
- - After investigation, some 3rd-party files were copied into the provided
- places within "/vector/static/3rd".
- - The following files were copied from the original vector skin:
- - /skins/vector/csshover.htc
- - /skins/vector/main-ltr.css
- - /skins/vector/main-rtl.css
- - /skins/vector/images/*
- - The following files were copied from Andreas Gohr's "default" template:
- * /default/*.css (see <http://j.mp/eq8zSo> why I did that)
- * /default/images/closed.gif
- * /default/images/favicon.ico
- * /default/images/link_icon.gif
- * /default/images/mail_icon.gif
- * /default/images/open.gif
- * /default/images/tocdot2.gif
- * /default/images/windows.gif
-
- - Edited:
- - "/vector/static/3rd/vector/main-ltr.css"
- "/vector/static/3rd/vector/main-rtl.css"
- All url() rules were edited (-> replaced "url(images/" through
- "url(static/3rd/vector/", deleted "?1" and "?2 postfixes").
- To make this clear, a comment was added at the top of the files:
- /* ATTENTION: This file was edited for the "vector template for DokuWiki".
- - All url() rules where changed.
- See README for details. */
-
- - "/vector/static/3rd/dokuwiki/design.css"
- All url() rules were edited (-> replaced "url(images/" through
- "url(static/3rd/dokuwiki/").
- To make this clear, a comment was added at the top of the files:
- /* ATTENTION: This file was edited for the "vector template for DokuWiki".
- - All url() rules where changed.
- See README for details. */
-
- - Visited <http://en.wikipedia.org/w/index.php?title=ASCII>, copied the XHTML
- source and let Tidy do the dirty work to get a valid clean and correctly
- indented base markup (after core removal, for sure). This markup was then
- compared with the current main.php and needed changes where done.
-
- - Created new files:
- * "vector/static/css/print.css"
- * "vector/static/css/rtl.css"
- * "vector/static/css/screen.css"
- All relevant information should be found within the inline comments.
-
- - Worked worked worked a few days.... and done! :-P
-
- - After ~1 year, I switched the CSS base from DokuWiki's default template
- to <http://www.dokuwiki.org/template:starter>. See
- <http://www.freelists.org/post/dokuwiki/Core-devs-I-need-some-info-to-keep-my-templates-maintainable>
- for more information about this. I edited some files, see
- "vector/static/3rd/dokuwiki/00_starter-tmpl-notes.txt" for details.
+
+ I. About
+
+ "vector"[1] is a template to offer the MediaWiki/Wikipedia 2010 Look&Feel
+ for DokuWiki.
+
+ It is a mostly optical port of the original MediaWiki skin and was created
+ by me (Andreas Haerter[2]).
+
+ [1] <http://www.dokuwiki.org/template:vector>
+ [2] <http://andreas-haerter.com/>
+
+
+
+ II. Installation and update
+
+ The installation works as described[1] on DokuWiki.org. Extract the
+ downloaded archive into your DokuWiki's "lib/tpl/" folder. Then select the
+ template in the Config Manager by adjusting the template option.
+
+ See the vector template website for instructions[2].
+
+ NOTE: If everything will be displayed unformatted, your PHP environment is
+ probably affected by PHP bug #49692[3]. You may find errors like
+ "syntax error, unexpected '/' in ../../lib/tpl/vector/style.ini on
+ line XX" in your PHP logs when this is the case. vector provides a
+ workaround for this, simply delete vector's "style.ini" to trigger
+ the template to use it.
+
+ [1] <http://www.dokuwiki.org/template>
+ [2] <http://www.dokuwiki.org/template:vector#update>
+ [3] <http://bugs.php.net/bug.php?id=49692>
+
+
+
+ III. Customizing the template
+
+ In order to make updates of your installed "vector" template easy, follow
+ these hints for customizing the template:
+
+ - Place your files in "vector/user"
+ The place for *all* userdefined, custom stuff is "vector/user".
+ Reason: this folder will not be touched on updates. Therefore you may
+ delete everything except "vector/user" and copy all new files into
+ "vector/" to update without loosing your changes. Do not forget to
+ empty your browser's cache afterwards.
+
+ - Own logo
+ If you want to replace the default logo showed in the upper left, simply
+ create a "logo.[png|gif|jpg]" in "vector/user". The template recognizes
+ the file automatically and will use it instead of the default text. Do not
+ forget to empty your browser's cache afterwards.
+
+ - Own favicon
+ If you want to replace the default favicon, simply create a "favicon.ico"
+ in "vector/user". The template recognizes the file automatically and
+ will use it instead of the default one. Do not forget to empty your
+ browser's cache afterwards. By the way: you might find the online
+ FavIcon Generator[1] useful.
+ Note: "favicon.png" is also possible but not recommended (because it is
+ not supported by older MSIE versions).
+
+ - Own CSS
+ To apply additional CSS rules, edit "vector/user/screen.css"
+ (influences normal layout) and/or "vector/user/print.css" (influences
+ print layout) and/or "vector/user/rtl.css" (influences "right-to-left"
+ languages like Hebrew). These files will be included automatically (as the
+ last ones for the relevant media, therefore you are able to overrule
+ existing styles). Do not forget to empty your browser's cache afterwards.
+
+ - Own JavaScript
+ To load additional JavaScript, edit "vector/user/user.js". Do not
+ forget to empty your browser's cache afterwards.
+ ATTENTION: You have to activate the template option "vector_loaduserjs"
+ (->"Load 'vector/user/user.js'?") in the DokuWiki Config
+ Manager!
+
+ - Own CSS, language specific
+ To apply additional CSS rules only for a specific language, edit/create
+ "vector/lang/<your-language>/style.css". This file will be included
+ automatically if DokuWiki runs/shows a page in the language of choice (as
+ the last one, therefore you are able to overrule existing styles). Do
+ not forget to empty your browser's cache afterwards.
+
+ - Own tabs
+ To apply own tabs, have a look at "vector/user/tabs.php". Don't worry:
+ you will find some examples how to define the tabs. If you still have
+ questions after playing with the examples, see "IV. Support" on how to get
+ help. If "vector/user/tabs.php" does not exist, simply copy it out of
+ the current actual installation archive.
+
+ - Own footer buttons
+ To apply own buttons/graphics in the footer (-> these small 80x15 pics),
+ have a look at "vector/user/buttons.php". Don't worry: you will find
+ some examples how to define the buttons. If you still have questions
+ after playing with the examples, see "IV. Support" on how to get help.
+ If "vector/user/buttons.php" does not exist, simply copy it out of the
+ current actual installation archive.
+
+ - Own boxes
+ To apply own boxes in the left column/sidebar, have a look at
+ "vector/user/boxes.php". Don't worry: you will find some examples how to
+ define the boxes. If you still have questions after playing with the
+ examples, see "IV. Support" on how to get help.
+ If "vector/user/boxes.php" does not exist, simply copy it out of the
+ current actual installation archive.
+
+ - Web analytics software (Piwik, Google Analytics etc.)
+ Tools like Piwik and Google Analytics normally provide a small code
+ snippet ("tag") which you have to include at your website to make
+ everything work. If you want to use such software with this template, have
+ a look at "vector/user/tracker.php". This file exists to make it easier
+ for you. You don't have to deliberate where you have to copy and paste the
+ code, simply do it there.
+
+ - Own Apple Touch Icon
+ If you want to replace the default Apple Touch Icon, simply create a
+ "apple-touch-icon.png" in "vector/user". The template recognizes the
+ file automatically and will use it instead of the default one. Have a
+ look at Apple's developer database (cf. "Configuring Web Applications"[2])
+ if you need more information.
+
+ [1] <http://tools.dynamicdrive.com/favicon/>
+ [2] <http://j.mp/sx3NMT>
+
+
+
+ IV. Support
+
+ If you need help, check the FAQ[1] and try to find useful information by
+ using the DokuWiki Search page[2]. If you found nothing helpful, ask your
+ question at the DokuWiki forum[3] (preferred) or IRC channel[4].
+
+ [1] <http://www.dokuwiki.org/template:vector#faq>
+ [2] <http://search.dokuwiki.org/>
+ [3] <http://forum.dokuwiki.org/>
+ [4] <http://www.dokuwiki.org/irc>
+
+
+
+ V. Contact
+
+ If you think you found a bug or you got a useful idea (a.k.a. "feature
+ request"), create an issue[1] on GitHub (preferred), or contact me by
+ mail[2].
+
+ Feel free to submit patches as GitHub pull requests (preferred) or by mail
+ as well. However, please try to respect the DokuWiki coding style[3] as this
+ template follows its rules.
+
+ [1] <https://github.com/bitkollektiv/dokuwiki-template-vector/issues>
+ [2] Andreas Haerter <ah@bitkollektiv.org>
+ [3] <http://www.dokuwiki.org/devel:coding_style>
+
+
+
+ VI. Other notes
+
+ If you like this free project, you might buy me a coffee[1], or get some
+ cool QR Code merchandise[2]. Thank you! :-)
+
+ I am no native English speaker. If you find any errors please let me
+ know[3]. Otherwise, my English is not getting better (as desired by myself).
+
+ [1] <http://bitkollektiv.org/donate/dokuwiki-template-vector/>
+ [2] <http://goqr.me/>
+ [3] Andreas Haerter <ah@bitkollektiv.org>
+
+
+
+ VII. Explanatory notes about the dirs of this template
+
+ - "vector/conf"
+ Contains some configuration files (do NOT edit them!), especially
+ - default.php: default settings[1]
+ - metadata.php: configuration metadata[2]
+
+ - "vector/lang"
+ Language files (subdir names = language code). You may copy the English
+ language files and translate them if your language is missing. Simply send
+ me the translated files (cf. "V. Contact") and I will include them in the
+ next release :-D.
+
+ - "vector/static"
+ Static files (images, CSS, JavaScript). The interesting stuff is located
+ in subdirs (as described below).
+ - "3rd"
+ Static files originally taken from a third party like MediaWiki or
+ DokuWiki. The subdir "dokuwiki" contains files originally taken from the
+ DokuWiki "default" or "starter" template. The subdir "vector" contains
+ files taken from the MediaWiki "vector" skin.
+ - "css"
+ All non-3rd-party Cascading Style Sheets (CSS). See my tutorial[3] for
+ more information about how the CSS is handled.
+ - "img"
+ All non-3rd-party images files.
+ - "js"
+ All non-3rd-party JavaScript files.
+
+ - "vector/user"
+ Place for userdefined stuff. E.g. if you want use an own logo, simply copy
+ a logo.[png|gif|jpg] in here. See "III. Customizing the template" for
+ details.
+
+ [1] <http://www.dokuwiki.org/devel:configuration#default_settings>
+ [2] <http://www.dokuwiki.org/devel:configuration#configuration_metadata>
+ [3] <http://j.mp/eq8zSo>
+
+
+
+ VIII. Creation transcript
+
+ Some developers may find this interesting. Additionally, I am very oblivious
+ :-P.
+
+ - Downloaded the nightly MediaWiki build (cause only the SVN version is
+ containing the vector skin as I'm writing this) from
+ <http://toolserver.org/~vvv/mw-nightly/>.
+
+ - Installed DokuWiki (Release "2009-12-25c", "Lemming") for testing purpose.
+
+ - Copied all "monobook for DokuWiki" sources cause it already fits some of
+ my needs regarding config options and non-layout features. Means: I used
+ the source of the "monobook for DokuWiki" template as base for "vector for
+ DokuWiki".
+
+ - replaced "monobook" through "vector" in:
+ - /conf/*
+ - /lang/*
+ - /bug49642.php
+ - /detail.php
+ - /inc_cite.php
+ - /inc_detail.php
+ - /inc_mediamanager.php
+ - /main.php
+ - /mediamanager.php
+
+ - After investigation, some 3rd-party files were copied into the provided
+ places within "/vector/static/3rd".
+ - The following files were copied from the original vector skin:
+ - /skins/vector/csshover.htc
+ - /skins/vector/main-ltr.css
+ - /skins/vector/main-rtl.css
+ - /skins/vector/images/*
+ - The following files were copied from Andreas Gohr's "default" template:
+ - /default/*.css (see <http://j.mp/eq8zSo> why I did that)
+ - /default/images/closed.gif
+ - /default/images/favicon.ico
+ - /default/images/link_icon.gif
+ - /default/images/mail_icon.gif
+ - /default/images/open.gif
+ - /default/images/tocdot2.gif
+ - /default/images/windows.gif
+
+ - Edited:
+ - "/vector/static/3rd/vector/main-ltr.css"
+ "/vector/static/3rd/vector/main-rtl.css"
+ All url() rules were edited (-> replaced "url(images/" through
+ "url(static/3rd/vector/", deleted "?1" and "?2 postfixes").
+ To make this clear, a comment was added at the top of the files.
+
+ - "/vector/static/3rd/dokuwiki/design.css"
+ All url() rules were edited (-> replaced "url(images/" through
+ "url(static/3rd/dokuwiki/").
+ To make this clear, a comment was added at the top of the files.
+
+ - Visited <http://en.wikipedia.org/w/index.php?title=ASCII>, copied the
+ XHTML source and let Tidy do the dirty work to get a valid clean and
+ correctly indented base markup (after core removal, for sure). This markup
+ was then compared with the current main.php and needed changes where done.
+
+ - Created new files:
+ - "vector/static/css/print.css"
+ - "vector/static/css/rtl.css"
+ - "vector/static/css/screen.css"
+ All relevant information should be found within the inline comments.
+
+ - Worked worked worked a few days.... and done! :-P
+
+ - After ~1 year, I switched the CSS base from DokuWiki's default template
+ to <http://www.dokuwiki.org/template:starter>. See <http://j.mp/f7V4ES>
+ for more information about this. I edited some files, see
+ "vector/static/3rd/dokuwiki/00_starter-tmpl-notes.txt" for details.
+
View
270 README-de
@@ -1,148 +1,140 @@
-Titel: LiesMich des vector-Templates für DokuWiki
-Erstellungsdatum: 2010-05-29
-Letzte Änderung: 2011-11-24
-Autor: Andreas Haerter <development [ät] andreas-haerter.com>
-Web: <http://andreas-haerter.com/projects/dokuwiki-template-vector>
- <http://www.dokuwiki.org/template:vector>
-
-
ACHTUNG: Diese Datei stellt eine AUSZUGSWEISE Übersetzung der wichtigsten Teile
der englischsprachigen README dar. Für den vollständigen Text bitte die
Datei "README" in diesem Verzeichnis einsehen.
-
-I. Das Template benutzen/installieren
- "vector" zu nutzen ist einfach und funktioniert genau wie unter
- <http://www.dokuwiki.org/template> beschrieben: Entpacken Sie das
- heruntergeladene Archiv in das "lib/tpl/"-Verzeichnis Ihrer DokuWiki. Wählen
- Sie es dann einfach im Config Manager über die "template"-Option aus. Fertig.
- :-)
-
- Falls Sie eine bestehende vector-Installation aktualisieren wollen, werfen
- Sie bitte einen Blick auf <http://www.dokuwiki.org/template:vector>. Dort
- sollten Sie alle benötigten Informationen finden.
-
- HINWEIS: Falls alles unformatiert angezeigt wird, ist Ihre PHP-Umgebung ggf.
- vom PHP bug Nr. 49692 betroffen (s. entsprechender Bugreport unter
- <http://bugs.php.net/bug.php?id=49692>). Sie finden evtl. Einträge
- wie "syntax error, unexpected '/' in ../../lib/tpl/vector/style.ini
- on line XX" in Ihren PHP-Logs falls dies der Fall sein sollte.
- vector bietet einen Workaround für diesen Fehler an, löschen Sie
- einfach vectors "style.ini" um das Template dazu zu bewegen,
- selbigen zu nutzen.
-
-
-
-II. Das Template anpassen
- Um Aktualisierungen/Updates des installierten "vector"-Templates einfach zu
- gestalten, halten Sie sich bitte an die folgenden Hinweise um das Template
- anzupassen:
-
- - Eigene Dateien in "vector/user" ablegen
- Der Ort für *alle* benutzerdefinierten, angepassten Dinge/Dateien ist
- "vector/user".
- Grund: dieses Verzeichnis wird bei Aktualisierungen nicht angerührt. Daher
- können Sie einfach alles außer "vector/user" löschen und alle neuen
- Dateien nach "vector/" kopieren um das Template zu aktualisieren, ohne
- Ihre Änderungen zu verlieren. Vergessen Sie nicht Ihren Browser-Cache
- anschließend zu leeren.
-
- - Eigenes Logo
- Falls Sie das Standard-Logo, welches in der linken oberen Ecke angezeigt
- wird, austauschen wollen, legen Sie einfach eine "logo.[png|gif|jpg]"-Datei
- im "vector/user"-Ordner an. Das Template erkennt die Datei automatisch und
- wird sie anstelle des Standard-Logos verwenden. Vergessen Sie nicht Ihren
- Browser-Cache anschließend zu leeren.
-
- - Eigenes Favicon
- Falls Sie das Standard-favicon austauschen wollen, legen Sie einfach eine
- "favicon.ico"-Datei im "vector/user"-Ordner an. Das Template erkennt die
- Datei automatisch und wird sie anstelle des Standard-Favicons verwenden.
- Vergessen Sie nicht Ihren Browser-Cache anschließend zu leeren. By the way:
- Vielleicht finden Sie das folgende Online-Werkzeug nützlich:
- <http://tools.dynamicdrive.com/favicon/>
- Hinweis: "favicon.png" ist ebenfalls möglich, wird aber nicht empfohlen (da
- es von den meisten MSIE-Versionen nicht unterstützt wird).
-
- - Eigene CSS
- Um eigene CSS-Regeln anzuwenden, editieren Sie einfach
- "vector/user/screen.css" (beeinflusst das normale Erscheinungsbild)
- und/oder "vector/user/print.css" (beeinflusst das Druck-Erscheinungsbild)
- und/oder "vector/user/rtl.css" (beeinflusst "rechts-nach-links"-Sprachen
- wie Hebräisch). Diese Dateien werden automatisch eingebunden (als letzte
- für das relevante Ausgabemedium, daher können Sie auch existierende Styles
- überschreiben). Vergessen Sie nicht Ihren Browser-Cache anschließend zu
- leeren.
-
- - Eigenes JavaScript
- Um zusätzliches JavaScript zu laden, editieren Sie einfach
- "vector/user/user.js". Vergessen Sie nicht Ihren Browser-Cache
- anschließend zu leeren.
- ACHTUNG: Vergessen Sie nicht die Template-Option "vector_loaduserjs"
- (->"Datei 'vector/user/user.js' laden?") im DokuWiki Config
- Manager zu aktivieren!
-
- - Eigene CSS, sprachspezifisch
- Um eigene CSS-Regeln nur für eine bestimmte Sprache anzuwenden,
- editieren/erstellen Sie einfach "vector/lang/<ihre-sprache>/style.css".
- Diese Datei wird automatisch eingebunden, sobald DokuWiki in der Sprache der
- Wahl betrieben wird/eine Seite anzeigt (als letzte, daher können Sie auch
- existierende Styles überschreiben). Vergessen Sie nicht Ihren Browser-Cache
- anschließend zu leeren.
-
- - Eigene Tabs
- Um eigene Tabs anzuzeigen, editieren Sie einfach "vector/user/tabs.php".
- Kein Sorge: Sie finden dort einige Beispiele wie eigene Tabs definiert
- werden. Falls Sie nach dem ausprobieren der Beispiele immernoch Fragen
- haben, durchsuchen Sie am besten <http://dokuwiki.org/template:vector>
- und/oder das DokuWiki-Forum unter <http://forum.dokuwiki.org> und/oder
- fragen Sie die dortige Gemeinschaft falls Sie die Probleme beim
- Konfigurieren der eigenen Tabs nicht selbst lösen können.
- Falls "vector/user/tabs.php" nicht existiert, kopieren Sie die Datei
- einfach aus dem aktuellen Installationsarchiv.
-
- - Eigene Fußleisten-Buttons (Footer)
- Um eigene Buttons/Grafiken in der Fußleiste anzuzeigen (-> die kleinen
- 80x15 Bildchen), editieren Sie einfach "vector/user/buttons.php".
- Kein Sorge: Sie finden dort einige Beispiele wie eigene Buttons definiert
- werden. Falls Sie nach dem ausprobieren der Beispiele immernoch Fragen
- haben, durchsuchen Sie am besten <http://dokuwiki.org/template:vector>
- und/oder das DokuWiki-Forum unter <http://forum.dokuwiki.org> und/oder
- fragen Sie die dortige Gemeinschaft falls Sie die Probleme beim
- Konfigurieren der eigenen Buttons nicht selbst lösen können.
- Falls "vector/user/buttons.php" nicht existiert, kopieren Sie die Datei
- einfach aus dem aktuellen Installationsarchiv.
-
- - Eigene Boxen
- Um eigene Boxen in der linken Spalte anzuzeigen, editieren Sie einfach
- "vector/user/boxes.php". Kein Sorge: Sie finden dort einige Beispiele wie
- eigene Boxen definiert werden. Falls Sie nach dem ausprobieren der
- Beispiele immernoch Fragen haben, durchsuchen Sie am besten
- <http://dokuwiki.org/template:vector> und/oder das DokuWiki-Forum unter
- <http://forum.dokuwiki.org> und/oder fragen Sie die dortige Gemeinschaft
- falls Sie die Probleme beim Konfigurieren der eigenen Buttons nicht selbst
- lösen können.
- Falls "vector/user/boxes.php" nicht existiert, kopieren Sie die Datei
- einfach aus dem aktuellen Installationsarchiv.
-
- - Einbinden von Web-Analyse-Software (Piwik, Google Analytics etc.)
- Tools wie Piwik und Google Analytics benötigen normalerweise einen kleinen
- Code-Schnipsel ("tag"), welchen man auf der eigenen Website einbinden muss,
- damit alles funktionieren kann. Sofern man solche Software mit diesem
- Template einsetzen will, sollte man sich die Datei "vector/user/tracker.php"
- anschauen. Sie existiert, um die Integration einfacher zu gestalten und man
- nicht überlegen muss, wo solche Codes eingefügt werden müssen: dies ist
- der korrekte Platz dafür.
-
- - Eigenes Apple Touch Icon
- Falls Sie das Standard-Apple-Touch-Icon austauschen wollen, legen Sie
- einfach eine "apple-touch-icon.png"-Datei im "vector/user"-Ordner an.
- Das Template erkennt die Datei automatisch und wird sie anstelle des
- Standard-Icons verwenden. Falls Sie mehr Information über das Touch Icon
- benötigen finden Sie diese in der Apple Developer Datavase ("Configuring Web
- Applications" <http://j.mp/sx3NMT>).
+ II. Installation und Aktualisierung
+
+ "vector" zu nutzen ist einfach und funktioniert wie unter
+ <http://www.dokuwiki.org/template> beschrieben: Entpacken Sie das
+ heruntergeladene Archiv in das "lib/tpl/"-Verzeichnis Ihrer DokuWiki. Wählen
+ Sie es dann einfach im Config Manager über die "template"-Option aus.
+
+ Falls Sie eine bestehende vector-Installation aktualisieren wollen, werfen
+ Sie bitte einen Blick auf <http://www.dokuwiki.org/template:vector>. Dort
+ sollten Sie alle benötigten Informationen finden.
+
+ HINWEIS: Falls alles unformatiert angezeigt wird, ist Ihre PHP-Umgebung ggf.
+ vom PHP bug Nr. 49692 betroffen (s. entsprechender Bugreport unter
+ <http://bugs.php.net/bug.php?id=49692>). Sie finden evtl. Einträge
+ wie "syntax error, unexpected '/' in ../../lib/tpl/vector/style.ini
+ on line XX" in Ihren PHP-Logs falls dies der Fall sein sollte.
+ vector bietet einen Workaround für diesen Fehler an, löschen Sie
+ einfach vectors "style.ini" um das Template dazu zu bewegen,
+ selbigen zu nutzen.
+
+
+
+ II. Das Template anpassen
+
+ Um Aktualisierungen/Updates des installierten "vector"-Templates einfach zu
+ gestalten, halten Sie sich bitte an die folgenden Hinweise um das Template
+ anzupassen:
+
+ - Eigene Dateien in "vector/user" ablegen
+ Der Ort für *alle* benutzerdefinierten, angepassten Dinge/Dateien ist
+ "vector/user".
+ Grund: dieses Verzeichnis wird bei Aktualisierungen nicht angerührt. Daher
+ können Sie einfach alles außer "vector/user" löschen und alle neuen
+ Dateien nach "vector/" kopieren um das Template zu aktualisieren, ohne
+ Ihre Änderungen zu verlieren. Vergessen Sie nicht Ihren Browser-Cache
+ anschließend zu leeren.
+
+ - Eigenes Logo
+ Falls Sie das Standard-Logo, welches in der linken oberen Ecke angezeigt
+ wird, austauschen wollen, legen Sie einfach eine "logo.[png|gif|jpg]"-
+ Datei im "vector/user"-Ordner an. Das Template erkennt die Datei
+ automatisch und wird sie anstelle des Standard-Logos verwenden. Vergessen
+ Sie nicht Ihren Browser-Cache anschließend zu leeren.
+
+ - Eigenes Favicon
+ Falls Sie das Standard-favicon austauschen wollen, legen Sie einfach eine
+ "favicon.ico"-Datei im "vector/user"-Ordner an. Das Template erkennt die
+ Datei automatisch und wird sie anstelle des Standard-Favicons verwenden.
+ Vergessen Sie nicht Ihren Browser-Cache anschließend zu leeren.
+ Vielleicht finden Sie das folgende Online-Werkzeug nützlich:
+ <http://tools.dynamicdrive.com/favicon/>
+ Hinweis: "favicon.png" ist ebenfalls möglich, wird aber nicht empfohlen
+ (da es von älteren MSIE-Versionen nicht unterstützt wird).
+
+ - Eigene CSS
+ Um eigene CSS-Regeln anzuwenden, editieren Sie einfach
+ "vector/user/screen.css" (beeinflusst das normale Erscheinungsbild)
+ und/oder "vector/user/print.css" (beeinflusst das Druck-Erscheinungsbild)
+ und/oder "vector/user/rtl.css" (beeinflusst "rechts-nach-links"-Sprachen
+ wie Hebräisch). Diese Dateien werden automatisch eingebunden (als letzte
+ für das relevante Ausgabemedium, daher können Sie auch existierende Styles
+ überschreiben). Vergessen Sie nicht Ihren Browser-Cache anschließend zu
+ leeren.
+
+ - Eigenes JavaScript
+ Um zusätzliches JavaScript zu laden, editieren Sie einfach
+ "vector/user/user.js". Vergessen Sie nicht Ihren Browser-Cache
+ anschließend zu leeren.
+ ACHTUNG: Vergessen Sie nicht die Template-Option "vector_loaduserjs"
+ (->"Datei 'vector/user/user.js' laden?") im DokuWiki Config
+ Manager zu aktivieren!
+
+ - Eigene CSS, sprachspezifisch
+ Um eigene CSS-Regeln nur für eine bestimmte Sprache anzuwenden,
+ editieren/erstellen Sie einfach "vector/lang/<ihre-sprache>/style.css".
+ Diese Datei wird automatisch eingebunden, sobald DokuWiki in der Sprache
+ der Wahl betrieben wird/eine Seite anzeigt (als letzte, daher können Sie
+ auch existierende Styles überschreiben). Vergessen Sie nicht Ihren
+ Browser-Cache anschließend zu leeren.
+
+ - Eigene Tabs
+ Um eigene Tabs anzuzeigen, editieren Sie einfach "vector/user/tabs.php".
+ Kein Sorge: Sie finden dort einige Beispiele wie eigene Tabs definiert
+ werden. Falls Sie nach dem ausprobieren der Beispiele immernoch Fragen
+ haben, durchsuchen Sie am besten <http://dokuwiki.org/template:vector>
+ und/oder das DokuWiki-Forum unter <http://forum.dokuwiki.org> und/oder
+ fragen Sie die dortige Gemeinschaft falls Sie die Probleme beim
+ Konfigurieren der eigenen Tabs nicht selbst lösen können.
+ Falls "vector/user/tabs.php" nicht existiert, kopieren Sie die Datei
+ einfach aus dem aktuellen Installationsarchiv.
+
+ - Eigene Fußleisten-Buttons (Footer)
+ Um eigene Buttons/Grafiken in der Fußleiste anzuzeigen (-> die kleinen
+ 80x15 Bildchen), editieren Sie einfach "vector/user/buttons.php".
+ Kein Sorge: Sie finden dort einige Beispiele wie eigene Buttons definiert
+ werden. Falls Sie nach dem ausprobieren der Beispiele immernoch Fragen
+ haben, durchsuchen Sie am besten <http://dokuwiki.org/template:vector>
+ und/oder das DokuWiki-Forum unter <http://forum.dokuwiki.org> und/oder
+ fragen Sie die dortige Gemeinschaft falls Sie die Probleme beim
+ Konfigurieren der eigenen Buttons nicht selbst lösen können.
+ Falls "vector/user/buttons.php" nicht existiert, kopieren Sie die Datei
+ einfach aus dem aktuellen Installationsarchiv.
+
+ - Eigene Boxen
+ Um eigene Boxen in der linken Spalte anzuzeigen, editieren Sie einfach
+ "vector/user/boxes.php". Kein Sorge: Sie finden dort einige Beispiele wie
+ eigene Boxen definiert werden. Falls Sie nach dem ausprobieren der
+ Beispiele immernoch Fragen haben, durchsuchen Sie am besten
+ <http://dokuwiki.org/template:vector> und/oder das DokuWiki-Forum unter
+ <http://forum.dokuwiki.org> und/oder fragen Sie die dortige Gemeinschaft
+ falls Sie die Probleme beim Konfigurieren der eigenen Buttons nicht selbst
+ lösen können.
+ Falls "vector/user/boxes.php" nicht existiert, kopieren Sie die Datei
+ einfach aus dem aktuellen Installationsarchiv.
+
+ - Einbinden von Web-Analyse-Software (Piwik, Google Analytics etc.)
+ Tools wie Piwik und Google Analytics benötigen normalerweise einen kleinen
+ Code-Schnipsel ("tag"), welchen man auf der eigenen Website einbinden
+ muss, damit alles funktionieren kann. Sofern man solche Software mit
+ diesem Template einsetzen will, sollte man sich die Datei
+ "vector/user/tracker.php" anschauen. Sie existiert, um die Integration
+ einfacher zu gestalten und man nicht überlegen muss, wo solche Codes
+ eingefügt werden müssen: dies ist der korrekte Platz dafür.
+
+ - Eigenes Apple Touch Icon
+ Falls Sie das Standard-Apple-Touch-Icon austauschen wollen, legen Sie
+ einfach eine "apple-touch-icon.png"-Datei im "vector/user"-Ordner an.
+ Das Template erkennt die Datei automatisch und wird sie anstelle des
+ Standard-Icons verwenden. Falls Sie mehr Information über das Touch Icon
+ benötigen finden Sie diese in der Apple Developer Datavase ("Configuring
+ Web Applications" <http://j.mp/sx3NMT>).
[...Ende der AUSZUGSWEISEN Übersetzung der englischsprachigen README. Für den
View
2  style.ini
@@ -20,7 +20,7 @@
; Define the stylesheets your template uses here. The second value
; defines for which output media the style should be loaded. Currently
; print, screen and rtl are supported. rtl styles are loaded additionally
-; to screen styles if a right-to-left language is selected (eg. hebrew)
+; to screen styles if a right-to-left language is selected (e.g. Hebrew)
[stylesheets]
; screen
View
2  user/rtl.css
@@ -1,4 +1,4 @@
-/* en: Place for user defined CSS rules (right to left languages, e.g. hebrew) -
+/* en: Place for user defined CSS rules (right to left languages, e.g. Hebrew) -
this file can safely be preserved when updating. See README for details.
de: Ort für benutzerdefinierte CSS-Regeln ("rechts-nach-links"-Sprachen,
Please sign in to comment.
Something went wrong with that request. Please try again.