Programovací stavebnice Mini-web (Mw)

   Zde na webu je pouze rámcový slovní popis pro orientaci a vybrané
 pokyny pro zhájení práce. Kompletní referenční vzory prováděcích 
 i navrhovacích příkazů jsou uvedeny v příručce, která je přístupná
 z hlavní stránky "Zápisník" po instalaci prostředí Mini-web.

   V této úvodní etapě (srpen 2023) jsou popisována základní pravidla 
 pro ovládání dávkového pracovního prostředí Mini-web a systematické 
 laické navrhování webových stránek.

   Všechny soubory stavebnice, příkazové skripty Windows i programy Python
 jsou 100% transparentní, takže lokálně je lze prohlížet do všech detailů.

   Příručka kromě toho obsahuje kompletní převod příkazů i f-značek Mw-jazyka
 do zdrojového kódu HTML/CSS. Současně popisuje možnosti tvorby a spouštění
 jak příkazových skriptů Windows, tak programů Python s tím, že postupně 
 budou doplněny i jednoduché vzory.

   Po zvládnutí práce se zadáváním úloh a navrhováním stránek je tak možné
 využít prostředí Mini-web ke studiu a příkladům ve třech směrech:
   / zdrojový kód jazyka HTML, kaskádových stylů CSS a příp. jazyka JavaScript
   / úvod do programování příkazových skriptů Windows
   / úvod do programování v jazyku Python  

<<<

 1
   Postup při tvorbě webových stránek pomocí stavebnice (!!!)         Mini-web
   ---------------------------------------------------------------------------
 2
   Práce se stavebnicí vypadá tak, že si uživatel v souboru Rizeni-prace
   nejprve sestaví úlohu, tj. zvolí stránku pro 1. vytvoření nebo aktualizaci.

   Potom opakovaně spouští skript EDA, který nabídne editaci návrhu prvků, 
   které má stránka obsahovat a z návrhu vygeneruje výslednou webovou stránku.
   Každou změnu, kterou uživatel v návrhu realizuje, tak může následně okamžitě 
   kontrolovat prohlížečem.
    
   Popsaná koncepce umožňuje tvořit stránku postupně po malých krocích
   a tím zásadně celý vývojový proces zjednodušuje. 

   K sestavení úloh a datového obsahu stránek slouží Mw-jazyk, pomocí kterého 
   jsou zapisovány pokyny v souboru Rizeni-prace a v souborech návrhů stránek.  

   Návrh stránky spočívá v kombinaci příkazů pro vkládání typizovaných šablon
   s příslušnými parametry a řádků přímo vkládaného textu. V řádcích parametrů
   i přímo vkládaného textu mohou být tzv. formátovací značky.
 
 3
   I Sestavení aktuální úlohy                    Rizeni-prace
   I Návrh stránky                               *.txt
   O Výsledná webová stránka                     *.htm

   I = vstup, manuálně vytvořený uživatelem, O = automaticky vytvořený výstup

 4 (!!!)
   Základní podmínkou pro úspěšné zahájení práce se stavebnicí Mini-web
   je přiměřená zručnost při ovládání oken a příkazových tlačítek.

   Není to žádná věda, ale při navrhování stránek běžně nastává situace,
   kdy jsou na ploše současně otevřena minimálně 3 okna a někdy i více.
   Uživatel se v nich stále musí spolehlivě orientovat a umět je ovládat.

   V kapitole "Návody a komentáře" jsou proto sepsány
   (!!!) Potřebné dovednosti pro ovládání oken Windows.

<<<

<<<

 1
   Pracovní prostředí stavebnice                                        Mini-web 
   -----------------------------------------------------------------------------
 2
   K práci se stavebnicí si pomocí zástupce na ploše otevřeme okno pracovní
   složky, kde v souboru "Rizeni-prace" budeme sestavovat aktuální úlohy, 
   které pak budeme opakovaně spouštět ovládacím skriptem EDA.

   Pomocí zástupce v pracovní složce si vedle otevřeme okno prohlížeče s hlavní 
   stránkou "Zapisnik" s odkazy, užitečnými při ladění i prohlížení výsledků. 
 3
   Plocha
   -----------------------------------------------------------------------------
     zástupce pro přístup do pracovní složky               Mini-web.lnk            

   Okno hlavní stránky                                     Zápisník
   -----------------------------------------------------------------------------
   Mini-web:
     automatický rozcestník - výsledné stránky             *.htm
     automatický rozcestník - návrhy stránek               *.txt
     protokol z aktuálního spuštění skriptu EDA            Protokol.txt
     aktuální stav nastavení úloh                          Řízení-práce.txt
     referenční přehled možností stavebnice a Mw-jazyka    Příručka  

   Okno pracovní složky                                    Mini-web
   -----------------------------------------------------------------------------
     knihovna výsledných webových stránek                  složka "htm"
       hlavní stránka Mini-web                               Zapisnik.htm        
     vyhrazená složka dodaného pg-vybavení                 složka "prog"
     vyhrazená složka dodaných šablon                      složka "sablony"
       vyhrazená složka referenční dokumentace               složka "prirucka"
     knihovna návrhů stránek                               složka "txt"
       návrh hlavní stránky v Mw-jazyku                      Zapisnik.txt  

     hlavní ovládací skript                                EDA.cmd                 
     soubor pro sestavování úloh                           Rizeni-prace.txt       
       příkaz k aktualizaci v Mw-jazyku                      /,Zapisnik 
     zástupce pro zobrazení hlavní stránky                 Zapisnik.lnk            

<<<

Počítač - programování - jazyk Python

 Počítač, jako stroj na zpracování dat, ke svému fungování potřebuje:
   technické vybavení (hardware)
     vstup - paměť - procesor - výstup - napájení

   programové vybavení (software) je souhrn pokynů, které obsahují:
     "proměnné" = pojmenované části paměti pro ukládání dat 
     "příkazy"  = pojmenované pokyny, které s proměnnými pracují 
     "zdrojový kód" = souhrn pokynů v některém programovacím jazyku

 Programovací jazyky:
   - programování se od poloviny 20. stol. vyvíjelo velice rychle
   - přitom byla vytvořena více než stovka programovacích jazyků
   - většinou mají vlastní terminologii i pravidla zápisu programu

   Nejznámnější aktuální přehled světové popularity programovacích jazyků
     nabízi www.tiobe.com/tiobe-index.
   V jeho statistice nejsou z formálních důvodů zahrnuty jazyky HTML/CSS,
   které jsou jako jazyky všech webových stránek sice nejpoužívanější,
   ale obecně nepopopisují algoritmy jako takové.

 Jazyk Python:
   - jako "proměnné" rozlišuje řadu datových typů, kolektory a jiné
   - pro pokyny k práci s "proměnnými" nepoužívá jen příkazy, 
     ale i funkce, metody a další, s vazbou na řadu různých knihoven
   - pro zachování snadné srozumitelnosti budeme v našem výkladu  
     používat zobecněný jednotný termín "příkaz" a zájemci o podrobnosti
     si je mohou najít v odborné dokumentaci  

<<<

Uživatelské programování Python

 1. V Pracovní složce Mini-web vytvoříme uživatelskou složku "pg-me".
    Ve vyhrazené složce "prog" otevřeme soubor "idle-pyw.txt".
 
 2. Ve Windows otevřeme nabídku "Hledat" (ikona "lupa"), zadáme "IDLE" 
    a NESTISKNEME Enter, ale vpravo klikneme na "Otevřít umístění souboru".

 3. V novém okně v řádku "IDLE.." PT vybereme "Vlastnosti" a z okénka
    zkopírujeme obsah kolonky "Cíl" za původní text souboru dle 1.

 4. Zkontrolujeme, zda se zkopírovaná adresa v uvozovkách shoduje 
    s adresou na 1. řádku. Když je jiná, nahradíme s ní adresu ".. *.pyw"
    na 1. řádku (parametr %1 ponecháme).
    V obou případech pak zkopírované řádky smažeme.

 5. Upravený soubor "prog/idle-pyw.txt" uložíme jako "prog/idle-pyw.cmd".
    Správné fungování ověříme příkazem "pg-me/pg1.py" v "Řízení-práce" 
    a spuštěním EDA, který nabídne editaci nového programu "pg1.py" v IDLE.

<<<

První kroky v prostředí Python IDLE

 - do okna IDLE zkopírujeme zdrojový kód pg1.py z následujícího vzoru
 - kombinací Ctrl+S kód uložíme a stiskem klávesy F5 program spustíme
 - objeví se nám nové okno, ve kterém můžeme s programem komunikovat

 - práce, kterou vzorový program realizuje by měla být zřejmá,
   rovněž programátorské názvy proměnných by měly být jasné,
   stejně tak jako intuitivní povinné (!) odsazování zápisu kódu

 - při základní znalosti angličtiny měly by být srozumitelné i příkazy,
   složené z vyhrazených slov:
    print, while, input, if, append, else, for, in, import, sort

 - přiřazovací příkaz "=" přiřadí ke jménu proměnné uvedenou hodnotu
    Txt = "vstup", Txt = input("vstup"), Sez = []
   nebo definuje datový typ, tj, "proměnná je seznam"

 - operátor "!=" znamená "nerovná se", "rovná se" by bylo "=="

 - realizace českého třídění sestává ze 3 částí:
    přiřazení knihovny (import), nastavení jazyka (setlocale "czech")
    a setřídění seznamu (Sez.sort)

 - program také názorně ukazuje všechny 3 základní algoritmy, kterými
   je možno popsat jakýkoliv problém:
      1) posloupnost (vše musí jít postupně a mít začátek i konec)

      2) větvení (při splnění určitých podmínek se zpracování rozdělí)
           "if ...:", "else:" nebo "if ...:", "elif ...:, ..., "else:"

      3) opakování (určitá část kódu se shodně vícekrát opakuje)
           "while podmínka:" - (pokud platí podmínka)
           "for podmínka:"


 český překlad populární učebnice: howto.py.cz
 oficiální anglická dokumentace: docs.python.org/3/
 spustitelný program pro Windows zipapp (vyžaduje kompilátor C)

<<<

Zdrojový kód seznamovacího programu pg1.py

# ------------------ úvodní ohlášení programu
print("pg1 - Řádky textu z klávesnice do paměti a výpis:")
print("ukončení = stisk pouze Enter")
print()
# ------------------ definování proměnných pro vstup a seznam
Txt = "vstup"
Sez = []


# ------------------ vstup řádků textu do seznamu v paměti
while Txt != "":
    Txt = input("vstup: ")
    if Txt != "":
        Sez.append(Txt)
    else:
        print()

# ------------------ výpis hodnoty proměnné "seznam"
print(Sez)
print()
# ------------------ výpis řádků ze seznamu
for Pol in Sez:
    print(Pol)
print()


# ------------------ funkce pro české ABC třídění seznamu
import locale
locale.setlocale(locale.LC_ALL,'czech')
Sez.sort(key=locale.strxfrm)
# ------------------ výpis setříděných řádků ze seznamu 
for Pol in Sez:
    print(Pol)
print()

# ------------------ zpráva o ukončení programu
print("končím, ahoj - pg1 :o)")

<<<