HOME

5h-3LL 1.0
DIR: /srv/http/adent.cz/tisic.cz.test4-citroen/pages/help
/srv/http/adent.cz/tisic.cz.test4-citroen/pages/help/
Current File : /srv/http/adent.cz/tisic.cz.test4-citroen/pages/help/master-slozky.php
<?php /*
 title=Nápověda pro administraci stránek
 &description=Karlův cvičební MVC, aby pochopil, jak se dneska programuje :)
 &keywords= 
 &role=master
 &groups=
*/ ?>

<h1>Adresářová struktura SPZ</h1>

<div class="adc-tabs">
    <ul>
        <li class="active"><a href="#obsah">Obsah</a></li>
        <li><a href="#sablony">Šablony</a></li>
        <li><a href="#konfigurace">Konfigurace</a></li>
        <li><a href="#css">(S)CSS</a></li>
        <li><a href="#js">JS</a></li>
        <li><a href="#php">PHP</a></li>
        <li><a href="#vendor">Vendor</a></li>
    </ul>
  
    <!-- Obsah -->
    <div class="active" id="obsah">
        <ul>
            <li><code>/img/</code> - obrázky
                <ul>
                    <li><code>/img/</code> - obrázky pro stránky</li>
                    <li><code>/img/adent/</code> - ADENT loga apod. (třeba pozadí pro administraci)</li>
                    <li><code>/img/admin/</code> - fotky pro obrázek v loginu (ano, jmenuje se to blbě :)</li>
                    <li><code>/img/favicon/</code> - favicony pro stránku, administraci a nápovědu</li>
                    <li><code>/img/photogalleries/</code> - složka pro fotogalerie</li>
                </ul>
            </li>
            <li><code>/pages/</code> - statické stránky
                <ul>
                    <li>z toho:</li>
                    <li><code>/pages/help/</code> - stránky nápovědy (kterou právě čteš :)</li>
                    <li><code>/pages/admin/</code> - administrace</li>
                </ul>
            </li>
            <li><code>/uploads/</code> - složka pro soubory (ke stažení a tak)</li>
            <li><code>/LINKS-DOWNLOADS/</code> - podklady (co jsme dostali od klienta, co jsme si kvůli němu/webu stáhli a tak)</li>
    </div>    

    <!-- Šablony -->
    <div id="sablony">
        <p>Šablony pro "slepení dat z databáze a HTML"; zpravidla obsahují HTML kód, do kterého se umísťují PHP proměnné pomocí <code>&lt;?= $promenna ?&gt;</code>.</p>
        <ul>
            <li><code>/elements/</code> - "šablony" pro elementy, např. fotogalerie ve stránce
                <ul>
                    <li><code>/elements/photogalleryXXX.php</code> - "obalovač" pro zobrazení fotogalerie ve stránce (XXX spojuje "sadu zobrazení", která se dá přiřadit kadé fotogalerii jako výchozí zobrazovací sada)</li>
                    <li><code>/elements/photogalleryXXX-oneImage.php</code> - šablona, která se (pro každý obrázek fotogalerie) vkládá do "obalovače"</li>
                    <li><code>/elements/photogalleryXXXLink.php</code> - šablona pro "fotogalerii jako odkaz"</li>
                    <li><code>/elements/showLogin</code>, resp. <code>/elements/showUser</code> - šablona pro přihlášení, resp. zobrazení uživatele</li>
                    <li>-</li>
                    <li><code>/elements/samples/</code> - ukázky pro nápovědu</li>
                </ul>
            </li>
            <li><code>/views/</code> - šablony pro statické stránky
                <ul>
                    <li><code>/views/layuot, admin, help, login</code> - hlavní layouty stránek</li>
                    <li><code>/views/photogallery...</code> - layouty pro fotogalerie (vkládají se do hlavního layoutu)</li>
                    <li><code>/views/error</code> - layout pro chybovou stránku (vkládá se do hlavního layoutu)</li>
                    <li>-</li>
                    <li><code>/views/samples</code> - ukázky pro nápovědu</li>
                </ul>
            </li>
    </div>    

    <!-- Konfigurace -->
    <div id="konfigurace">
        <ul>
            <li><code>/elements/data/</code> - zatím to tu je spíš jen dočasně, mělo by se rozmyslet, až mi budou fungovat databáze a administrace...
                <ul>
                    <li><code>/elements/data/addressToControllerDictionary</code> - konfigurace alternativních adres pro "velké elementy" (zatím jen fotogalerie)</li>
                    <li>-</li>
                    <li><code>/elements/data/menu</code> - "databáze" s menu</li>
                    <li><code>/elements/data/users</code> - "databáze" s uživateli</li>
                    <li><code>/elements/data/groups</code> - "databáze" se skupinami uživatelů</li>
                    <li><code>/elements/data/photogalleries</code> - "databáze" s fotogaleriemi</li>
                </ul>
            </li>
    </div>    

    <!-- CSS -->
    <div id="css">
        <p><del>Škrtnuté jsou složky/soubory, které by se neměly (při stylování nového webu) moc měnit...</del></p>
        <ul>
            <li><del><code>/css/</code></del> - obsahuje vygenerované CSS z <code>/scss/</code>
                <ul>
                    <li><em>Poznámka: CSS komponent třetích stran (např. LightBox) je ve složce komponenty ve</em> <code>/vendor/</code> (<em>např.</em> <code>/vendor/lightbox/css/</code>)</li>
                </ul>
            </li>
            <li><code>/fonts/</code> - obsahuje vložené fonty</li>
            <li><code>/scss/</code> - SCSS styly pro SPZ:
                <ul>
                    <li><del><code>/scss/mixins/</code></del> - mixiny (pomocné "funkce", které by se neměly moc měnit) např. pro menu</li>
                    <li><code>/scss/partials/</code> - SCSS pro jednotlivé části stránek <strong>(tohle především by se mělo editovat :)</strong>:
                        <ul>
                            <li><del><code>/scss/partials/_reset</code></del> - resetovací / normalizační kus CSS (staženo někde na internetu...:)</li>
                            <li><code>/scss/partials/_adc-variables</code> - proměnné, např. barvy pro stránky</li>
                            <li><del><code>/scss/partials/_adc-mixins</code></del> - mělo by jenom připojovat mixiny z <code>/scss/mixins</code></li>
                            <li><code>/scss/partials/_adc-fonts</code> - "registrace" vlastních fontů (<em> se až posledních pár řádků!</em>)</li>
                            <li><code>/scss/partials/_adc-typo</code> - definice typografie hlavně (<em>výchozí velikosti písma, nadpisů, seznamů, mezer mezi nimi apod.</em>)</li>
                            <li><code>/scss/partials/_adc-typo-spz-tables</code> - CSS pro různé tabulky</li>
                            <li><code>/scss/partials/_adc-typo-spz-forms</code> - CSS pro prvky formulářů</li>
                            <li><code>/scss/partials/_adc-typo-spz-messages</code> - systémové zprávy SPZ; jde vypnoyt zakomentováním v <code>/scss/partials/_adc-typo</code></li>
                            <li><code>/scss/partials/_adc-typo-spz-autolinkicons</code> - automatické ikony pro odkazy; jde vypnoyt zakomentováním v <code>/scss/partials/_adc-typo</code></li>
                            <li><code>/scss/partials/_adc-layout</code> - definice hlavního layoutu (rozložení) celých stránek; kopíruje se z několika předpřipravených variant<br> (<em>"proužky", grid atd. - cílem je pak do kódu stránky psát jen jeden <code>&lt;div&gt;</code> za druhým a <strong><em>neřešit jejich umístění</em></strong></em>)</li>
                            <li><code>/scss/partials/_adc-body</code> - typicky pro definici barev různobarevných "proužků"; často může zůstat úplně prázdné</li>
                            <li><code>/scss/partials/_adc-header</code> - hlavička (barvy, velikosti, rozmístění v hlavičce apod.)</li>
                            <li><code>/scss/partials/_adc-main</code> - tělíčko (dtto)</li>
                            <li><code>/scss/partials/_adc-footer</code> - patička (dtto)</li>
                            <li><code>/scss/partials/_adc-elements</code> - stylování elementů ("malé" - taby, harmonika, čtvercové obrázky apod., ale i "velké" - fotogalerie apod.)</li>
                        </ul>
                    </li>
                    <li><del><code>/scss/partials/adent/</code></del> - kopie výše uvedeného pro administraci a nápovědu (takže neměnit pls :)</li>
                    <li><del><code>/scss/style.scss</code></del> - šablona, do které se "jen importuje všechno důležité" (takže se tu i zapíná/vypíná import Bootstrapu a FontAwesome)</li>
                    <li><del><code>/scss/style-adent.scss</code></del> - šablona pro nápovědu (a zatím i administraci), do které se "jen importuje všechno důležité"</li>
                    <li><del><code>/scss/style-login.scss</code></del> - šablona pro "login stránku"</li>
                </ul>
            </li>
        </ul>
    </div>
  
    <!-- JS -->
    <div id="js">
        <ul>
            <li><code>/js/adc-ui.js</code> - malé adentí skripty pro uživatelské rozhraní a elementy SPZ</li>
            <li><code>/js/adc-cosi.js</code> - malé adentí skripty pro jednotlivé stránky (zatím tam je jen skript pro líného Karla, který najde URL adresu a udělá z ní odkaz...:)</li>
        </ul>
    </div>
	
    <!-- PHP -->
    <div id="php">
        <ul>
            <li><code>/php/</code> - jádro SPZ</li>
        </ul>
    </div>
	
    <!-- Vendor -->
    <div id="vendor">
        <ul>
            <li><code>/vendor/</code> - začleněný <em>kompletní</em> kód třetích stran (galerie, slidery, FontAwesome...)</li>
        </ul>
    </div>
	
</div>