====== Themedoku ======

===== Bugs =====

Hat es gerade keinen, der mich wirklich nervt oder von dem ich Kenntnis habe. Ich hadere jedoch noch ein wenig mit dem a:active hover Hintergrund in der Navigation.

===== Namensräume =====

Eine <text type="danger">systematische</text> Unterteilung in verschiedene Namensräume ermöglicht:

  - nach Bedarf Fullwidth Container für Landingpages zu nutzen (via Reguläre Ausdrücke!!)
  - somit die Navigation auf den Landingspages auszublenden
  - und darüber hinaus auch Headerbilder nach Wunsch pro Namensraum frisch zu setzen

  ?id=start:header
  
Die obige Seite enthält das Headerbild für den Namensraum start: in den Abmessungen 1920x200 zentriert. Damit die Seite selbst beim Wechseln von einem Namensraum in einen anderen nicht hüpft, müssen alle Bilder im Header die gleichen Abmessungen haben.

Wer mal gucken will: diese Funktion ist [[https://www.kvfg.de|auf der KvFG Homepage]] umgesetzt.

===== Navbar =====

Auf die Nutzung der Navbar zur Site-Navigation wurde hier verzichtet. Die Navbar listet hier als Default nur externe Dienste. Wer da mehr / anderes haben will, sollte sich mit den Namensräumen auskennen und diese systematisch einsetzen. 

In der mobilen Ansicht wird die Seitenleiste automatisch in die Navbar integriert. Das ist jedoch eine Einstellung des Templates Bootstrap. 

===== Plugin: Blog =====

Um die - bei vielen kürzeren Beiträgen - störenden Linien los zu werden, wird der Footer ausgeblendet:

  {{blog>:blog?7&nofooter}}
  
Sind die meisten Beiträge länger, dann kann hierauf verzichtet werden.

Weitere Hinweise im Abschnitt Startseite.

===== Plugin: Fontface =====

Aktuell nutzt die Seite Nunito - lokal gehostet.

https://google-webfonts-helper.herokuapp.com/fonts/nunito?subsets=latin

Die Einstellungen im Plugin wurden dann wie folgt gesetzt:

https://www.dokuwiki.org/plugin:fontface

{{:theme:bootstrap:plugin-fontface.png|}}

Für copy and paste Fanatiker also so:

<code>
$conf['plugin']['fontface']['technique'] = 'fontface';
$conf['plugin']['fontface']['fontFile'] = 'nunito-v16-latin-regular';
$conf['plugin']['fontface']['fontName'] = 'Nunito';
$conf['plugin']['fontface']['elements'] = 'body';
$conf['plugin']['fontface']['genericFamily'] = 'sans-serif';
$conf['plugin']['fontface']['elements2'] = '';
</code>

===== Plugin: Navi =====

https://www.dokuwiki.org/plugin:navi

Wird Navi in der Sidebar wie folgt angesprochen:

  {{navi>sidebarcontent?ns&js}}
  
dann enstehen in der Navigation hässliche Doppeleinträge. Wirft mensch das 

  ?ns&js
  
raus, dann entstehen diese nicht. 

===== Startseite =====

Sofern auf der Startseite ein Nachrichtenbereich inkludiert werden soll:

Es gibt den Namensraum

  blog:start
  
Dort wird das [[https://www.dokuwiki.org/plugin:blog|Plugin Blog]] genutzt - mit den üblichen Einstellungen.

Die Startseite bindet diese Unterseite mit Hilfe des [[https://www.dokuwiki.org/plugin:include|Plugins include]] ein mit

  {{page>:blog:start}}

oder besser noch

  {{page>:blog:start&noheader&nofooter&noeditbutton}}  

und "doppelt" damit die Inhalte aus dem Nachrichtenbereich.

:!: Der Eintrag für die Nachrichtenseite in der Navigation kann dann entfallen :!:

Warum? Damit in der Seitenübersicht nicht alle Blogeinträge im Bereich der Startseite herumhängen, sondern schön dort aufgeräumt sind, wo sie eben hingehören: in den Nachrichten- / Blog-Bereich der Seite. Das ist house-keeping und "muss so".

Wer mal gucken will: diese Funktion ist [[https://karlo.kvfg.info/doku.php?id=start|auf Karlo]] umgesetzt.

===== Template: Bootstrap3 =====

https://www.dokuwiki.org/template:bootstrap3

Pi mal Daumen sieht das so aus: Nach und nach haben sich aber noch ein paar kleinere Änderungen ergeben - z.B. wurde TOC in die Navbar geschoben und die "kleinen Pagetools" für Besucher:innen wurden deaktiviert.

<code>
$conf['tpl']['bootstrap3']['bootswatchTheme'] = 'flatly';
$conf['tpl']['bootstrap3']['sidebarOnNavbar'] = 1;
$conf['tpl']['bootstrap3']['showTools'] = 'logged';
$conf['tpl']['bootstrap3']['showUserHomeLink'] = 0;
$conf['tpl']['bootstrap3']['hideLoginLink'] = 1;
$conf['tpl']['bootstrap3']['showIndividualTool'] = '';
$conf['tpl']['bootstrap3']['showAddNewPage'] = 'logged';
$conf['tpl']['bootstrap3']['schemaOrgType'] = 'BlogPosting';
$conf['tpl']['bootstrap3']['fluidContainer'] = 0;
$conf['tpl']['bootstrap3']['pageOnPanel'] = 0;
$conf['tpl']['bootstrap3']['landingPages'] = '(start)';
$conf['tpl']['bootstrap3']['showPageTools'] = 'logged';
$conf['tpl']['bootstrap3']['showPageId'] = 0;
$conf['tpl']['bootstrap3']['showLoginOnFooter'] = 1;
$conf['tpl']['bootstrap3']['showWikiInfo'] = 0;
$conf['tpl']['bootstrap3']['tocCollapsed'] = 1;
$conf['tpl']['bootstrap3']['tocLayout'] = 'navbar';
$conf['tpl']['bootstrap3']['googleAnalyticsNoTrackAdmin'] = 0;
$conf['tpl']['bootstrap3']['browserTitleCharSepNS'] = '|';
$conf['tpl']['bootstrap3']['useACL'] = 1;
$conf['tpl']['bootstrap3']['showPageIcons'] = 0;
$conf['tpl']['bootstrap3']['pageIcons'] = 'feed,send-mail,permalink,print';
$conf['tpl']['bootstrap3']['socialShareProviders'] = 'mastodon';
$conf['tpl']['bootstrap3']['tagsOnTop'] = 0;
$conf['tpl']['bootstrap3']['useAnchorJS'] = 0;
$conf['tpl']['bootstrap3']['semantic'] = '0';
$conf['tpl']['bootstrap3']['pageToolsAnimation'] = '0';
$conf['plugin']['bootswrapper']['loadBootstrap'] = '1';
$conf['tpl']['white']['tocPosition'] = 'dokuwiki';

</code>

===== userstyle.css =====

<code>

/* HEADER */

.navbar-default {
        background-color: white;
        border-color: white;
        }

/* BODY */

body {
  overflow-y: scroll; /* Show scrollbar to fix header pic */
}

#dokuwiki__header {
        width: 100%;
}

/* HEADLINES */

h2 { padding-top: 1em;
}

/* SIDEBAR */

.nav-pills {
        font-size: 15px;
}

/* Beauty added to navigation */

.nav-pills > li.active > a {
    color: #337ab7;
    background-color: white;
    border-bottom: 1px solid #2271b7;
    border-radius: 0px;
    font-weight: bold;
}

.nav-pills > li.active > a:focus {
    color: #337ab7;
    background-color: white;
    border-bottom: 1px solid #2271b7;
    border-radius: 0px;
    font-weight: bold;
}

.nav-pills > li > a:hover  {
    color: #337ab7;
    background-color: #dcdcdc;
    border-bottom: 1px solid #2271b7;
    border-radius: 0px;
    font-weight: bold;
}

.nav-pills > li.active > a:hover {
    color: #337ab7;
    background-color: #dcdcdc;
    border-bottom: 1px solid #2271b7;
    border-radius: 0px;
    font-weight: bold;
}

/* Mobile navigation bug hunt */


div.plugin__navi li, div.plugin__navi li.open {
    font-size: 15px;
    color: #337ab7;
    font-weight: normal;
    line-height: normal;
    text-shadow: none;
    opacity: 1;
}

.nav > li > a:focus {
    color: #337ab7;
    text-decoration: none;
    background-color: white;
    opacity: 1;
}

.nav > li > a:hover {
    color: #337ab7;
    text-decoration: none;
    background-color: white;
    opacity: 1;
}

/* more room around media file icons */

.dokuwiki a.urlextern, .dokuwiki a.windows, .dokuwiki a.mail, .dokuwiki a.mediafile, .dokuwiki a.interwiki {
  background-repeat: no-repeat;
  background-position: 0 center;
  padding: 0 0 0 20px;
}


</code>

===== detail.php =====

In <code>dokuwiki/lib/tpl/bootstrap3/detail.php </code> und dort in Zeile 384 steht als Plural für das Wort //Information// tatsächlich "Informations". Das geht ja überhaupt nicht ;-) Bug report und hier korrigiert.

https://github.com/giterlizzi/dokuwiki-template-bootstrap3/issues/605