prsnl10 Template

Compatible with DokuWiki

• 2012-01-25 "Angua" yes
• 2011-05-25 "Rincewind" yes
• 2010-11-07 "Anteater" yes

• Download
• Donate

Minimalist template for personal and portfolio websites

Last updated on

2011-12-10

Repository

Source

Tagged with clean, minimal, minimalist, personal, portfolio

By Andreas Haerter

• vector
• monobook
• mnml-blog

“prsnl10” is a clean and minimalist template for DokuWiki. It is designed to use DokuWiki as small CMS for portfolio websites and for other “non-wiki” purposes. The name means “personal template, year 2010” (cause I created it for my own website in the first place).

With that said, there's always room for improvement. If you're able to add any contributions to make prsnl10 better, please let me know or discuss your thoughts.

If you like the template, think about a donation. It is a lot of work.

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.

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

Refer to template on how to install and use templates in DokuWiki. For updating, see below.

Some screenshots can be found here.

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.

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 no rocket science.
3. Download the current update from above.
4. Uncompress it and copy it over your current /lib/tpl/prsnl10. This works without problems when you followed the rules described in the README (⇒ the place for *all* user-defined, custom stuff is /lib/tpl/prsnl10/user!) cause previously existing files in this directory are simply not included in the update archive (and therefore it can't overwrite anything of your stuff).
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

Feel free to add yours here:

• http://andreas-haerter.com
• http://ameyrick.co.uk/ffxiv
• http://www.jochenstadler.at
• http://www.heiko-barth.de/
• http://sieve.info/
• Djangos Homepage
• Xiang's Homepage
• Hannah Hiles Photography

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.

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

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.

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 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.

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

See customizing.

Please refer to the discussion page.

• Nothing special right now (but I will fix reported bugs, for sure!) — AndreasAndreas
  
  Horb a. N. / Karlsruhe, Germany 2011/05/02 07:34

• Nothing special right now — AndreasAndreas
  
  Horb a. N. / Karlsruhe, Germany 2011/05/02 07:34

• fix font style of italic acronyms (2011/12/10 19:19)
• release preparations (2011/12/10 19:00)
• typos (2011/12/02 21:44)
• fix plugin manager checkbox position (2011/12/02 21:17)
• improve background position of msg() icons (2011/12/02 21:05)
• css cleanup (2011/12/02 17:12)
• Improve compatibility with pre-Angua releases (2011/11/30 07:56)
• release preparations (2011/11/29 04:07)

For a complete change log, see the commits on Github. Older releases are no longer recommended for usage and are listed for reference only.

prsnl10 version	Download	Designed for and tested on DokuWiki	Comment
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.