====== Technical informations ======

This page contains technical information about wikipedia.

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

Dokuwiki has new template placed in `/lib/tpl/arkhalia_wiki_tpl`. it is template based on the original vanilla Dokuwiki template. There is several interesting places. 

At first there is a logo placed in `images/logo.png` which is replaced by "Arkhalia" logo. Then in %%css/basic.less%% 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 procedure (not a function, its 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:

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

And place it at the bottom of the file. Then you need to click on "Reset to default" in the UI Admin panel in color settings.

==== 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, the Arkhalia tpls will be persistent. However it is very likely that you just want different color settings. If you want better desing 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>