Mw-jazyk 1

příručka Mini-web



Příručka by měla naučit

  vše podstatné k prvnímu seznámení a získání základních zkušeností, jak s programovací stavebnicí pracovat.


 

  Obsahem příručky je popis ovládacího Mw-jazyka a výklad pojmů, který však v jiných souvislostech může být jiný.


     A) Vybrané příkazy ">" a "f-značky" k navrhování stránek

Stránka typu "A"

>A
Hlavní nadpis stránky
*=====================

"datový obsah stránky"

>Z-txl
Autor/ka
=

 

">A" zobrazí nadpis a současně definuje výšku
    plovoucích bloků 460px i další vlastnosti
    stránky, tj. typ písma, barvu pozadí, ...,
    proto může být v návrhu stránky jen jednou
"*=== atd" zajistí ukončení příkazu ">A" s linkou

">Z-txl" zobrazí tiráž dole pod linkou,
    se jménem nebo autorskou značkou 
"=" zajistí ukončení příkazu ">Z-txl"

Plovoucí blok typu "blok"

>blok
Nadpis bloku
============

"datový obsah bloku"

>-x


>D

 

">blok" zobrazí nadpis bloku šířky 360px
"=== atd" zajistí ukončení příkazu ">blok" 

Pokud datový obsah bloku začíná textem nebo odkazy,
je třeba použít f-značky pro odřádkování nebo 
pro odstavce, aby byl odsazen od nadpisu.

">-x" zajistí povinné ukončení každého bloku



">D" zajistí přerušení nebo ukončení
   posloupnosti plovoucích bloků

Obrázek v bloku

>os-o
adresa obrázku
=


 

">os-o" zobrazí obrázek na-šířku bloku,
   po kliknutí se zvětší v nové záložce
">ov-o" podobně zobrazí obrázek na-výšku,
   která je 60% výšky bloku
"=" zajistí ukončení uvedeného příkazu

Odkazy

>w
-,text odkazu,(_)
adresa odkazu
=
|: adresa odkazu :|: text odkazu :|

 

">w" otevře odkaz v nové záložce
"=" zajistí ukončení příkazu ">w"

:|: otevře odkaz v nové záložce,
.|: otevře odkaz ve stejném okně

"f-značky" pro formátování textu

(_) a //

/_odsazený odstavec textu_/
/o_oboustranně zarovnaný odstavec s odsazením_/
(t_text sázený tučně_t)
(mk_text sázený malou kurzívou_mk)

 

vložení pevné mezery a odřádkování

podrobnější pokyny viz Mini-web > 3 > 33 











Příkaz pro zobrazení Mw-kódu stránky

>Z-mw
Autor/ka - |: soubor.htm :|: HTM :|
soubor-mw-kodu.txt
=

 

Příkaz je zatím ověřován v alfa-verzi,
  proto není zahrnut v instalaci a je třeba
  zdrojový kód šablony ručně zkopírovat
  a uložit jako soubor ve složce "sablony" 

   Pro fungování příkazu je nezbytné, aby byl příslušný zdrojový Mw-kód zkopírován ze složky "txt" do složky "htm" a na web byl ukládán společně se stránkou, z něj vytvořenou. To lze zajistit ručně nebo dále uvedenými speciálními příkazy pro "Rízení práce" (skript obsahuje: copy txt\jm-stranky.txt htm\jm-stranky.txt).

  Ke snadnému duplicitnímu otevření stránky v nové záložce pro porovnání Mw-kódu s výsledkem vedle sebe, je doporučeno do tiráže uvádět též příslušný odkaz HTM dle výše uvedeného vzoru. Uvádění odkazu na Mw-kód (a HTM) je však vhodné používat pouze pro studijní účely a příklady - na běžných stránkách by to bylo matoucí(!).

Zdrojový kód šablony (kliknutím na řádek rozbalit)
z-mw.txt




     B) Příkazy pro řízení práce

Sestavení úlohy v souboru "Rizeni-prace"

Mini-web (Rizeni-prace.txt) 
=sablony                                     
   /,Zapisnik  
                                
/,stranka-1      /* stránka "zapnutá"
   /,stranka-2      /* stránka "vypnutá"
   ...  

call prog.gen



   ed txt/kopie.cmd
   call txt/kopie.cmd

 

"=sablony" přiřazuje knihovnu šablon HTML/CSS

sestavení úlohy:
 - každý příkaz musí být na samostatném řádku
 - "zapnutý" = příkaz začíná od 1. sloupce,
 - "vypnutý" = je odsunutý o 3 mezery


"call prog.gen" zajistí generování výstupu
podrobnější pokyny viz Mini-web > 3 > 32  

speciální příkazy:
 - vytvoření/editace skriptu *.cmd
 - spuštění skriptu *.cmd  

     C) Výklad pojmů a komentáře

Programovací stavebnice Mini-web

  je aplikace, poháněná programy Python a příkazovými skripty Windows, která významně zjednodušuje a urychluje tvorbu statických webových stránek.

  Statické webové stránky nevyužívají dynamické databáze dat na serveru poskytovatele a proto je je možná jejich tvorba a zobrazování i lokálně.

  Stavebnice Mini-web tak umožňuje využívat webové stránky "*.htm" jako zajímavou dokumentační alternativu k textům rodiny "*.doc" i prezentacím "*.pps".


Mw-jazyk

  je značkový jazyk, který umožňuje navrhovat webové stránky a řídit práci programovací stavebnice Mini-web.

  Návrh stránky v Mw-jazyku zapíše uživatel do souboru *.txt a stavebnice z něj vygeneruje stránku *.htm ve zdrojovém kódu HTML/CSS.

  Generování probíhá dle příkazů Mw-jazyka, nastavených jako aktuální úloha v souboru "Řízení práce", kterou lze dle potřeby opakovat.


Příkaz ">jmeno" v návrhu stránky

  zajistí, že do zdrojového kódu stránky bude vložena šabloha HTML kódu shodného jména. Ta může obsahovat značky "@1" až "@n", které budou nahrazeny parametry, uvedenými v následujících řádcích.

  Každý příkaz musí být na samostatném řádku od 1. sloupce a nesmí za ním být mezera. Na následujících dalších řádcích pak musí být předepsaný počet parametrů.

  Každý příkaz musí být ukončen mezerovým řádkem, jiným příkazem ">.." nebo značkami "=", "*===.." či "===..".


"f-značky"

  jsou symbolické zkratky českých názvů kdekoliv na řádku které zajistí, že do zdrojového kódu stránky budou vloženy příslušné značky nebo skupiny značek HTML kódu.

  Jsou potřebné především pro formátování textu, ale i pro odkazy a další. Při zobrazování webové stránky jsou totiž duplicitní mezery i řádková odsazení normálně ignorovány.


"festina lente" aneb "spěchej pomalu"

  "Metodu" dle nadpisu autor těchto řádků na základě více než 50-leté zkušenosti s programováním zdrojových kódů považuje za úplně nejdůležitější obecný návod k práci.

  Jde o to, že programování počítačů je činnost značně složitá a lidské smysly jsou oproti přesným schopnostem počítače mnohonásobně omezenější. A tak počítač umí vyhodnotit nepřesné souvislosti, které sebechytřejší člověk občas nedokáže zaregistrovat.

  Proto je třeba tuto vlastnost počítače pokorně vzít na vědomí a nenavrhovat x-věcí najednou, ale postupovat po úplně elementárních krocích. Stavebnice to svojí rychlostí snadno umožňuje.


 

  Pokud programátor tuto zásadu nedodržuje a snaží se "šetřit minuty" navrhováním více věcí najednou, dříve či později se určitě dožije situace, kdy bude nějakou hodinu a třeba i den hodně složitě hledat "proč to nechodí" a pak zjistí, že to byla úplně triviální maličkost. :o)

  Pro zpestření je dále pár souvisejících úvah a citátů od klasiků..

 


Mini-web, © Ing. Vlastimil Čevela 2024, aktualizace 19.04.2024-07:17