====== How to Modify the Template ======

This page contains technical information about wikipedia.

===== The Custom Arkhalia template =====

Dokuwiki has new template placed in ''/lib/tpl/arkhalia_wiki_tpl''. It is a template based on the original vanilla Dokuwiki template. 

There exists several interesting places.

==== Page logo change ====

There is a logo placed in ''images/logo.png'' which is replaced by the "Arkhalia" logo.

==== Font change ====

In ''css/basic.less'' there can be changed the overall font size and font type used in wiki:

<code>
body {  
    font: normal 92%/1.4 "Inter var", "ui-sans-serif", "system-ui";;
    /* default font size: 100% => 16px; 93.75% => 15px; 87.5% => 14px; 81.25% => 13px; 75% => 12px */
    -webkit-text-size-adjust: 100%;
}
</code>

==== The City Guard linter ====

Another interesting place in template is in the ''main.php'' where the original **article content rendering** procedure (not a function, it's a procedure :-) ):

<code>
    <?php tpl_content() ?>
</code>

Has been replaced by the logic of the linter:

<code>
if (!str_contains($buffer, '<h1')) {
  echo '👮‍️ Arkhalia Wiki guard: Please add h1 title into the Article. Reason: It doesn\'t look good to not have h1 caption in the Article.';
}
                    } 
</code>


==== The Color theme ====

The colors can still be changed in Admin panel, or can be placed at the botton of the ''style.ini'' file. You can grab a color setting from different template, like adoradark, a just place it at the bottom of the file:

<code>
[replacements]
;These overwrites have been generated from the Template styling Admin interface
;Any values in this section will be overwritten by that tool again
__text__ = "#eeeeee"
__background__ = "#222222"
__text_alt__ = "#dddddd"
__background_alt__ = "#444444"
__text_neu__ = "#cccccc"
__background_neu__ = "#333333"
__border__ = "#ff9900"
__highlight__ = "#aaaa66"
__link__ = "#ff9900"
__background_site__ = "#000000"
__existing__ = "#ffff88"
__missing__ = "#ff4433"
__site_width__ = "75em"
__sidebar_width__ = "16em"
__tablet_width__ = "800px"
__phone_width__ = "480px"
</code>

It will be then set as the Wiki default color setup and therefore you need to click on "Reset to default" in the UI Admin panel in color settings if you want changes to apply.


==== You can set colors in UI ====

Or you can modify colors in the Admin panel:

{{:en:color-settings.png?400|}}

==== Do not change the Template due to color setting ====

You can instal different template and try it, HOWEVER, I have tried lot of them (@jurass17) and their quality is quite low and gross. (As it is often seen in some open source community driven content) 

If you install different template, the Arkhalia template will be still there and you can return back to it. However take a note tak Akrhalia City Guard is binded to Arkhalia template.

It is very likely that you just want different color settings. If you want better design overall, then I'm skeptical it can be achieved with Dokuwiki templates.


==== The custom link to Arkhalia.pw ====

Another interesting place is in ''tpl_header.php'' where you can place custome link to Arkhalia.pw instead of Wiki Home page:

<code>
            tpl_link(
                'https://arkhalia.pw/',
                '<img src="' . $logo . '" ' . ($logoSize ? $logoSize[3] : '') . ' alt="" />',
                'accesskey="h" title="' . tpl_getLang('home') . ' [h]"'
            );
</code>


==== Logo size ====

Another interesting place is in ''css/design.less'' where one can override size of the logo:

<code>
#dokuwiki__header {

...

        img {
            float: left;
            margin-right: .5em;
            height: 70px;
            width: auto;
        }

</code>