DokuWiki

It's better when it's simple

User Tools

Site Tools


template:prsnl10

This is an old revision of the document!


prsnl10 Template

Compatible with DokuWiki

2010-11-07 "Anteater", 2011-05-25 "Rincewind", 2012-01-25 "Angua", 2012-10-13 "Adora Belle", 2013-03-06 "Weatherwax", 2013-12-08 "Binky",2014-05-05

template

Last updated on
2014-02-09
Repository
Source

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Similar to benjamin, ramtop

Tagged with clean, minimal, personal, portfolio

About

“prsnl10” is a minimalist template for DokuWiki. It is designed to use DokuWiki as CMS for portfolio websites and other “non-wiki” purposes. The name means “personal template 2010” because it was created for Andreas Haerter's personal website in 2010.

Download

:!: If you like the template, you might want to donate a few bucks, or get some cool QR Code generator merchandise. It is a lot of work. Thank you! :-)

Version 2014-02-09
Download 2014-02-09_prsnl10.tar.gz
  • Note for existing users: Since 2014-02-09, there is no separate update .tar.gz anymore. The current archive is used for both install and update now. Instead of providing a separate update archive without the /user sub-directory, all example files in /user are delivered with the .dist extensions now to make sure your files won't get overwritten. This should be easier an more DokuWiki-like than the previous approach.
Important release notes for 2014-02-09
  • :!: Fixed a major bug, the configuration option were un-savable on DokuWiki 2013-12-08 “Binky”
  • Full support for DokuWiki 2013-12-08 “Binky”.
  • There is no separate update archive anymore.

Repository (for developers)

The source code of this template is available as Git repository. You may find the text “How to create an easily maintainable DokuWiki template” useful, too.

Verify download (for geeks)

See CHECKSUMS.asc for MD5, SHA-1 and SHA-256 checksums. The file is signed with the GnuPG/PGP key (0x423B2839). You can use gpg --verify ./CHECKSUMS.asc to check/validate it.

Installation

  1. Refer to template on how to install and use templates in DokuWiki. For updating, see below.
  2. Create a header navigation. Have a look at “What are these "Please fill or disable this placeholder ([pagename])" everywhere?” to get help.

Support

If you need help:

If you found nothing helpful, ask your question at the DokuWiki forum (preferred) or IRC channel.

Contact

If you think you have found a bug or have a useful idea (a.k.a. “feature request”), create an issue on GitHub (preferred), or contact us by mail.

Feel free to submit patches as GitHub pull requests (preferred) or by mail as well. However, please try to respect the DokuWiki coding style as this template follows its rules.

Update

What to do to update your installed prsnl10 template?

  1. First of all: Backup your data, especially /lib/tpl/prsnl10.
  2. Don't be scared. It is not rocket science.
  3. Download the current update from above.
  4. Simply uncompress and copy it over your current /lib/tpl/prsnl10. This works without problems when you follow the rules described in the README (⇒ the place for *all* user-defined, custom stuff is /lib/tpl/prsnl10/user!) because previously existing files in /lib/tpl/monobook/prsnl10 will not be touched or overwritten.1)
  5. Here is a list of files that were removed in recent releases. They do no harm, but you should delete them to keep your installation clean and tidy:
    #removed in 2011-11-29
    /css/_mediamanager.css
    /css/basic.css
    /css/content.css
    /css/design.css
    /css/includes.css
    /css/structure.css

FAQ

What are these “Please fill or disable this placeholder ([pagename])” everywhere?

The template optionally imports normal wiki pages and shows their content as

  • header navigation
  • additional footer content (off by default)
  • copyright note (off by default, default is the common copyright note by DokuWiki)

This means you can create the page mentioned in the “Please fill or disable this placeholder” message (e.g. “:wiki:navigation_header”) and its content will be shown instead of the message. All of these placeholders are configurable. Have a look at the DokuWiki admin section:

  • Show header navigation?
  • If yes, use following wiki page as header navigation:
    […]
  • Show copyright notice?
  • If yes, use default copyright notice?
  • If not default, use following wiki page as copyright notice:
    […]
  • Show additional, custom footer content?
  • If yes, use following wiki page as additional footer content:
    […]

:!: If you need an example for a header navigation, try the following as content for the page configured at “If yes, use following wiki page as header navigation” (:wiki:header_navigation by default):

[[:start|Home]] / [[:contact|Contact]]

As mentioned above, just edit the page like every other wiki page to change the navigation.

How can I check which version is currently installed?

Simply have a look at /lib/tpl/prsnl10/VERSION. This is a textfile containing the version you are using (e.g. 2011-05-02).

How to change the logo/favicon/css[...]?

Browser compatibility

The template should be compatible with all modern browsers:

  • Firefox ≥ 3
  • Opera ≥ 10
  • Safari ≥ 4, Chrome ≥ 1 and other newer Webkit based browsers.
  • MS Internet Explorer ≥ 7

Please note:

  • MS Internet Explorer 6 is also supported in general, there are only some cosmetic issues at the admin menu. These issues do not affect normal wiki pages. The new Media Manager (introduced with DokuWiki 2011-11-10 “Angua RC1”) does not work with IE6.
  • I can't test every browser (version) out there. Therefore it does not mean the template does not work if your browser is not listed above. Just try it out if you want to be sure.

Customizing

Have a look at the README. Everything regarding

  • own logo
  • own favicon
  • own CSS
  • own JavaScript
  • own Apple Touch Icon (apple-touch-icon.png)

is described there.

For the ones who are never reading READMEs:

  • :!: The place for all user-defined, custom stuff is “prsnl10/user”. Reason: this folder will not be touched on updates.
  • :!: If you want to replace the default text logo showed in the upper left, simply create a /prsnl10/user/logo.[png|gif|jpg]. The template recognizes the file automatically and will use it instead of the default logo.

Hacks for /user/screen.css

…to insert into /prsnl10/user/screen.css (NOT /prsnl10/css/prsnl10_screen.css).2)

Less min-heigth / whitespace below main content

Open user/screen.css and insert:

.dokuwiki div#content {
    min-height: 300px !important;
}

Replace 300px with auto to completely remove the min-height (or use any other value fitting your needs). Default is 870px.

Version history

Older releases are no longer recommended for usage and are listed for reference only.

prsnl10 version Download Designed for and tested on DokuWiki Release notes and comments
2014-02-09 Release
No update archive anymore, the new tar.gz is used for both install and update.
2013-12-08 “Binky”,
2012-10-13 “Adora Belle”
:!: Fixed bug, un-savable configuration on 2013-12-08 “Binky”; Full support for DokuWiki 2013-12-08 “Binky”; Update support and contact information.
2013-11-17 Release
Update
rc2013-10-28 “Binky”,
2012-10-13 “Adora Belle”
Full support for DokuWiki rc2013-10-28 “Binky”; Add Korean language files; Update support and contact information.
2013-02-20 Release
Update
2012-10-13 “Adora Belle”,
2012-01-25b “Angua”
Added Danish language.
2012-10-17 Release
Update
2012-10-13 “Adora Belle”,
2012-01-25b “Angua”
Small style adjustments.
2012-10-14 Release
Update
2012-10-13 “Adora Belle”,
2012-01-25b “Angua”
Full support for DokuWiki 2012-10-13 “Adora Belle”; New table of contents (ToC) when using Adora Belle (smaller, no full-page-width anymore)
2011-12-10 Release
Update
rc2011-11-10 “Angua RC1”,
2011-05-25a “Rincewind”
Small layout fixes; Improved compatibility with pre-Angua releases.
2011-11-29 Release
Update
rc2011-11-10 “Angua RC1”,
2011-05-25a “Rincewind”
:!: Full support for DokuWiki's new Media Manager. New option to hide all admin links if the client is not an authenticated user. Apple Touch Icon support (see README for details).
2011-05-10 Release
Update
rc2011-05-08 “Rincewind RC2”,
2010-11-07 “Anteater”
Cross browser compatibility fixes.
2011-05-08 Release
Update
rc2011-04-22 “Rincewind RC1”,
2010-11-07 “Anteater”
Small browser compatibility fixes.
2011-05-02 Release rc2011-04-22 “Rincewind RC1”,
2010-11-07 “Anteater”
Initial release.

Latest changes

Sites using this Template

Localization

Russian

lib/tpl/prsnl10/lang/ru/lang.php
<?php
 
/**
 * Russian language for the "prsnl10" DokuWiki template
 *
 * @license GPLv2 (http://www.gnu.org/licenses/gpl2.html)
 * @author Aleksandr Selivanov <alexgearbox@yandex.ru>
 * @link https://www.dokuwiki.org/template:prsnl10
 */
 
 
//check if we are running within the DokuWiki environment
if (!defined("DOKU_INC")){
    die();
}
 
//links
$lang["prsnl10_lnk_print"] = "Версия для печати";
$lang["prsnl10_lnk_permrev"] = "Постоянная ссылка";
$lang["prsnl10_lnk_whatlinkshere"] = "Ссылки сюда";
$lang["prsnl10_lnk_siteindex"] = "Все страницы";
 
//other
$lang["prsnl10_search"] = "Поиск";
$lang["prsnl10_accessdenied"] = "Доступ запрещён";
$lang["prsnl10_fillplaceholder"] = "Пожалуйста, укажите значение или отключите";
$lang["prsnl10_donate"] = "Пожертвование";
$lang["prsnl10_templatefordw"] = "Стиль prsnl10 для «ДокуВики»";
$lang["prsnl10_recentchanges"] = "Последние изменения";
1)
except the example files with the .dist extension
2)
cause files in prsnl10/user/ will be preserved on updates, so you don't have to do your customizations over and over again
template/prsnl10.1408283581.txt.gz · Last modified: 2014-08-17 15:53 by 24.40.204.21

Except where otherwise noted, content on this wiki is licensed under the following license: 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