3 Mini-web
Základy práce se stavebnicí Mini-web (Mw)
Vyhrazené a uživatelské prvky
Při práci se stavebnicí Mw je třeba důsledně rozlišovat prvky vyhrazené, obsahující dodané programové(pg) vybavení a uživatelské, se kterými pracuje uživatel stavebnice.
Vyhrazené složky a soubory (Vo) jsou ty, které slouží výhradně pro fungování dodaného pg-vybavení. Uživatel při své práci nesmí jejich jména měnit, ani zasahovat do jejich obsahu.
Uživatelské složky a soubory s vyhrazeným jménem (Vj) jsou ty, se kterými dodané pg-vybavení pracuje. Uživatel nesmí měnit jejich jména, ale tvoří jejich obsah dle pravidel Mw-jazyka.
Běžné uživatelské složky a soubory jsou ty, které si uživatel může vytvořit, pojmenovat i naplnit dle vlastního uvážení. Pouze musí dodržet pravidla Mw-jazyka pro strukturu složek i souborů a jejich obsah.
Mw pracovní prostředí
Schema přístupu: Mini-web = zástupce na ploše: otevírá prac-složku "Mini-web" zástupce v prac-složce: otevírá stránku "Zápisník" Okno prohlížeče: Zapisnik.htm = pracovní MW-rozcestník (Vj) Okno pracovní složky: htm = složka výsledných stránek (Vj) prog = knihovna prog-vybavení (Vo) sablony = knihovna šablon (Vo) txt = složka návrhů stránek (Vj) EDA.cmd = hlavní ovládací skript (Vo) Rizeni-prace.txt > prováděcí příkazy (Vj) Zapisnik = zástupce > Zapisnik.htm Při spuštění skriptu EDA je pro přehlednost dobré odložit tlačítkem "_" černou obrazovku dolů. Postup při tvorbě webových stránek^ Pracovní prostředí stavebnice^ o <<<
Vyhrazené prvky Mw-jazyka
Vyhrazené prvky pro řízení práce:
- povinná dokumentační záhlaví (Pd)
- prováděcí příkazy (Pr)
Vyhrazené prvky pro navrhování webových stránek:
- příkazy pro vkládání šablon (Ps)
- pevný text a další příkazy zvláštního určení (Pz)
- formátovací značky (Fz)
Možnosti použití komentářů (Ko)
V následujících blocích jsou popsány pouze vybrané možnosti stavebnice pro zahájení práce. Po získání základních zkušeností a dovedností je k dispozici kapitola "Projekty ... atd". Ty významně usnadňují orientaci při zvýšeném počtu navrhovaných stránek nebo při práci na různých tématech.
Řízení práce - sestavení úlohy
Mini-web Mini-web (Rizeni-prace.txt) (Pd) =sablony (Pr) /,Zapisnik /* koment (Pr) zap /,Zapisnik /* koment (Pr) vyp /,jina-stranka /* koment (Pr) ... atd call prog,gen (Pr)
Sestavení aktuální úlohy v souboru Řízení práce^ Doporučení pro ladění návrhů stránek^
Návrh stránky - příkazy vkládání šablon (Ps)
>prikaz /* = jméno šablony parametr-1 parametr-2 parametr-3 ...více parametrů na 1 řádku:
>prikaz -,parametr-1,parametr-2 parametr-3 ...
zdrojové kódy HTML/CSS v knihovně šablon
o <<<
<< (Ps)
1 parametr na více řádcích:
>prikaz /+ radek-1 radek-2 ... +/ -,parametr-2,parametr-3,...
Jméno příkazu a počet jeho parametrů "n" (též n=0) odpovídá souboru v knihovně šablon a formálním parametrům "@n@" v příslušné šabloně HTML.
<< (Ps)
Řádek >prikaz může mít /* komentář .., odsazený minimálně jednou mezerou. Řádky s parametry musí následovat hned za ním. Žádný z parametrů nesmí začínat mezerou, chápal by se jen jako komentář. Řádek >prikaz může mít individuálně přiřazenou šablonu z uživatelské knihovny šablon "sb-me":
>prikaz=>sb-me
Každý vkládací příkaz musí být ukončen
/ podtržením "=", "===" nebo "======atd"
/ novým příkazem ">prikaz",
zvl. příkazy >, >:, >1 minulý příkaz NEUKONČÍ
/ mezerovým nebo prázdným řádkem
Návrh stránky - (Ps), (Pz), (Fz), (Ko)
Vytvoření studijní stránky m-n1
Obrazový sloupec a plovoucí bloky m-n2
Bloky s obrázky, videa a mapy m-n3
Blok s obrázky (rajce.idnes.cz) m-n31
Blok s aplikací Zonerama m-n32
Blok s aplikací videa YouTube m-n33
Blok s aplikací Mapy.cz m-n34
Běžné texty, odkazy a komentáře m-n4
Bloky s pevným textem m-n5
V návrhu stránky může být vymezena posloupnost příkazů, která bude mít individuálně přiřazenou uživatelskou knihovnu šablon "sb-me":
... příkazy =>sb-me ... příkazy =< ... příkazy
Převod f-značek MW-jazyka do zdrojového kódu HTML
o <<<
Možnosti použití komentářů (Ko)
Komentáře mohou mít v zásadě dva důvody
/ komentovat určitou část zdrojového kódu
/ vyřadit/zapojit určitou část zpracování
Mw-jazyk má k tomu značky od 1. sloupce,
shodné pro řízení práce i návrh stránky:
/*---*/, *.., /** (odkaz v min. bloku)
V souborech "Řízení práce" navíc funguje
odsazování příkazů na řádku o 3 mezery
a kdekoliv na řádku " /* koment".
V souborech s návrhy stránek " /* koment"
funguje pouze na řádcích ">prikaz",
a odsazení pro řádky parametrů.
Projekty a pokročilé navrhování webových stránek
Mw-jazyk - řízení práce - Sestavení aktuální úlohy^
Pokročilé prováděcí příkazy
....*....1....*....2....*....3....*....4....*....5....*....6....*....7....*....8....*....9....*....0....
Mini-web Mini-web (Rizeni-prace.txt) /* povinné dokumentační záhlaví > BLOK DÁLE *****
=sablony /* přiřazení knihovny šablon > BLOK DÁLE *****
/,Zapisnik /* koment zapnuto: editace a volba pro generování
/,Zapisnik /* koment vypnuto: -"-
/,jina-stranka /* koment
... atd
call prog,gen /* příkaz ke generování stránky
....*....1....*....2....*....3....*....4....*....5....*....6....*....7....*....8....*....9....*....0....
/,stranka /* stránka zapnuta pro editaci a generování
/,stranka /* ed-ne */ /* stranka zapnuta pro generování bez editace
/,stranka /* ed -ne */ /* stranka zapnuta pro editaci a generování
/,stranka /* stránka vypnuta (podobně všechny další příkazy)
/slozka/,stranka /* -"- analogicky (v projektu)
ed /,stranka /* editace návrhu "txt/stranka.txt" (bez generování)
ed /slozka/,stranka /* shodně pro "txt/slozka/stranka" (v projektu)
ed /slozka/,m-modul /* shodně pro modul, tj. dílčí část stránky
ed slozka/soubor.txt /* editace textového souboru (v různé struktuře)
ed slozka/skript.cmd /* editace příkazového skriptu windows
call slozka/skript.cmd /* spuštění příkazového skriptu (musí existovat)
call slozka/skript.cmd >> prog/protokol.txt /* se zápisem do protokolu
ed slozka/program.py /* editace programu python (bez IDLE)
slozka/program.py /* spuštění IDLE s programem python
call slozka/program.py /* spuštění programu (musí existovat)
call slozka/program.py >> prog/protokol.txt /* se zápisem do protokolu
new /slozka/ /* vytvoření projektu > BLOK DÁLE *****
/* zřídí "txt/slozka/_r-p.txt" a "htm/slozka"
slozka/_r-p.txt /* zapojení projektu do řízení práce
/* jen-RP -ne */ /* vypíše "řízení práce" do protokolu a skončí
/* jen-RP-ne */ /* pokračuje normálním zpracováním
trasa /2/ /* programátorské trasování do protokolu
trasa /2/ /* vypnuto
http /slozka/stranka /* generování ">w", "-,Xn,(__),http.." > BLOK DÁLE *****
http /slozka/stranka >prikaz /* generování řádku ">prikaz" před "http.."
call prog,gen /* skript "gen" z knihovny "prog/pg-doku.txt" > BLOK DÁLE *****
call prog,jm-lib /* obecně skript se jménem "jm-lib"
....*....1....*....2....*....3....*....4....*....5....*....6....*....7....*....8....*....9....*....0....
Dokumentační záhlaví
Povinné dokumentační záhlaví je určeno k tomu, aby se vypisovalo do protokolu pro systematický záznam o průběhu zpracování.
Je požadováno nejen v souboru "Řízení práce", ale automaticky se zapisuje do řídících souborů při vytváření projektů. Účel má ten, že z úvodní kapitoly protokolu se dá snadno vyčíst, které projekty byly v dané úloze aktivní.
Podobně je požadováno, aby bylo jako <! &---m-modul > uváděno na 1. řádku samostatných modulů, ze kterých je pak příkazem >&slozka/modul.txt sestavován návrh stránky. Řádek se běžně nezobrazuje, ale hraje zásadní roli při hledání ladících chyb pomocí "trasování" - viz kapitola "MW navrhování stránek".
Přiřazení knihovny šablon
S instalací je dodávána standardní knihovna šablon, obsahující HTML/CSS ekvivalenty vytipovaných základních příkazů. Princip používání šablon je však obecnou metodou pro definování různě složitých předem připravených zdrojových kódů jakýchkoliv programovacích kódů.
Proto Mini-web umožňuje tvorbu uživatelských knihoven šablon s doporučenými jmény sb-tema jak pro usnadnění navrhování stránek k určitým tématům, ale též pro případné generování programů/modulů JavaScript, Windows-skript, Python, či dalších.
Pokud je uživatelská knihovna šablon přiřazena v rámci projektu, tak se pro následující projekty automaticky vrátí základní přiřazení dle "Řízení-práce".
Změna přiřazení knihovny šablon je možná i v rámci návrhu stránky anebo přímo pouze pro konkretní příkaz - viz kapitola "MW navrhování stránek".
Vytvoření projektu
Řešení složitých úkolů se zjednoduší, pokud si je rozdělíme na menší části. Pokud budeme navrhovat více stránek anebo stránky pro různá témata, je velice užitečné si práci rozdělit do samostatných projektů.
Příkazem new /slozka/ bude projekt zřízen jako samostatná struktura složek, podřízených složkám "txt" a "htm" v hlavní pracovní složce Mini-web. Současně bude zřízen také soubor txt/slozka/_r-p.txt pro řízení práce projektu s povinným záhlavím */slozka/ na 1. řádku.
Projekt je nutno v souboru "Řízení-práce" řádkem slozka/_r-p.txt zapojit do zpracování a jeho soubor řízení práce v pracovní složce "Mini-web" zpřístupnit zástupcem s doporučeným názvem rp-slozka .
Generování odkazů
Usnadnění tvorby pracovních rozcestníků nebo galerie obrázků realizuje skupina příkazů, které z posloupnosti "adres-odkazů" vytvoří posloupnost skutečných odkazů.
1. posloupnost adres v návrhu modulu/stránky uvedeme jako komentář a zkontrolujeme, zda je skutečně ignorována:
/* >http adresa-odkazu-1 adresa-odkazu-2 ... <http */
2. před příkaz k editaci modulu/stránky v řízení práce vložíme jednu z variant příkazů, popsaných ve velkém vzoru nebo např.:
http /slozka/stranka >on1-o http /slozka/stranka >wtx ...
3. při následné editaci odstraníme vymezení komentářů. Pro variantu bez příkazu se na výsledné stránce se objeví posloupnost odkazů X1, X1, .. Xn. Zde uvedené příklady vytvoří řádek náhledů obrázků >on1-o nebo odkazy web, ke kterým je následně potřeba doplnit komentáře.
Dokumentační knihovna skriptů (LibD)
Pro nastavování různého chování má stavebnice též vyhrazenou dokumentační knihovnu skriptů, ze které je volán např. skript pro vlastní generování.
Její možné uživatelské využití bude výhledově popsáno v kapitole "Úvod do programování ...".
Uživatelská knihovna programů
Pro uživatelské programování je třeba do stavebnice doplnit jednu nebo několik knihoven programů s doporučenými jmény pg-tema.
Jejich využití je popsáno v kapitole "Úvod do programování ...".
Několik instalací Mini-web
Pro tematicky nebo organizačně samostatné oblasti může být výhodné a přehlednější mít v počítači několik instalací stavebnice Mini-web.
Její autor má např. samostatnou instalaci pro tuto Příručku s navazující dokumentací stavebnice na webu "prog-story" TM v Brně a další pro redakční systém MIM na webu ZŠ Modřice.
Z hlediska rychlého ovládání může být zajímavá samostatná instalece pro vlastní databázi tematicky rozdělených odkazů na webové zdroje.
Při více instalacích je však náročnější dodržení aktuálnosti verzí vyhrazených knihoven programů, šablon a Příručky.
Mw-jazyk - navrhování stránek - Návrh datových prvků stránky^ - ABC rejstřík příkazů a f-značky
Stránka od A do Z
stránka bez vymezovacích linek:
>A Nadpis-stránky ============== ... data ... >Z autorské-označení/zkratka =
stránka s linkou pod nadpisem a nad tiráží:
>A Nadpis-stránky *============= ... data ... >Z-txl autorské-označení/zkratka =
Stránka od A do Z - varianty 1/2
základní výška pro >blok = 460px:
>A Nadpis-stránky
výška bloků není omezená:
>An Nadpis-stránky
výška pro >blok zadaná, zde 400px:
>Ab -,Nadpis-stránky,400
varianta tiráže s textem/linkou před:
>Z-tx -,autorské-označení/zkratka,text/(=) =
Stránka od A do Z - varianty 2/2
lokální navigační lišta - hlavní Mw-rozcestník:
>A-nav Zápisník
lokální nav-lišta pro >Ab:
>Ab-nav Nadpis jiné lokální stránky
stránka bez příkazů A a Z:
prázdná bílá stránka:
- pro experimenty s textem a f-značkami/HTML
- vzor k prohlédnutí šablony příkazu:
(PT > Zobrazení zdrojového kódu v HTML)
>-----
příkaz
>příkaz
>-----
vytvoření studijní stránky^ --- o <<<
Plovoucí blok
výška pro >blok je definovaná v rámci stránky >A..,
šířka = 360px, blok je ukončen odstavcem s mezerou:
>blok Nadpis bloku ============ ... text, obrázky, odkazy ... >--
varianta bloku bez nadpisu:
>blok-x ======= ... text, obrázky, odkazy ... >--
varianta ukončení bloku bez mezerového odstavce:
>-x
bloky na stránce "plavou" zleva/dolů dle velikosti okna,
ukončení/přerušení plavání příkazem "dost":
>D = běžně, s linkou, s volným řádkem, s textem:
>D >Dl >Dr >Dt
plovoucí bloky^ --- o <<<
Plovoucí blok - varianty 1/2
pro ostatní varanty bloků není výška omezená,
varianta "široký blok" má šířku = 740px:
>blok-s Nadpis-bloku
varianta "velký blok" má šířku = 1140px:
>blok-v Nadpis-bloku
další šířky bloku 580px a 100% okna:
>blok-6 >blok-9
všechny bloky s nadpisem mohou být odkazovatelné:
>blok -,Nadpis-bloku,id
|: adresa-stránky.htm#id :|: odkaz na blok :|
shodné varianty pro bloky bez nadpisu::
>blok-x >blok-x6 >blok-xs >blok-xv >blok-x9
Plovoucí blok - varianty 2/2
blok s otevíracím obrázkem "na šířku": --- obrázky^
>blok Nadpis-bloku ============ >os-o adresa-obrázku >tx řádek textu s f-značkami >--
bloky s obrázkem v/š 350x240px, odkaz na ALBUM:
>blok-o adresa-obrázku
>blok-ota adresa-obrázku adresa-alba
malý náhledový blok s odkazem a 1-řádkovým textem *),
výška náhledu 100px:, --- příklad MIM > NOVINKY^
>blok-mnw text-pod-odkazem adresa-obrázku adresa-odkazu
analogická varianta základní s výškou náhledu 240px: *)
>blok-nw
*) tyto bloky nesmí být ukončeny příkazy ">--" ani ">-x"
Rozbalovací blok
blok se rozbalí/sbalí po kliknutí na řádek s černou šipkou vlevo, může mít víc úrovní, šířka není omezena:
>blok-dx Nadpis-bloku ============ ... rozbalovaný obsah ... >Dx
bloky s nadpisem o šířce 350, 580, 740, 1140px:
>blok-d3 >blok-d6 >blok-d7 >blok-v
varianta konce bloku bez ukončení plavání
a s ukončením a odřádkováním:
>-x >Dxr
obnova stránky se sbalením všech bloků <<< :
/p_|: stranka.htm .|: (t_<<<_t) :|_/
/a_|: stranka.htm .|: (t_<<<_t) :|_a/Rozbalovací menu z modulů:
>blok-dx -,Nadpis rozbalovacího bloku-1,m-blk1 ===================================== >&txt/projekt/m-blk1.txt >D >Dx >blok-dx -,Nadpis rozbalovacího bloku-2,m-blk2 ===================================== >&txt/projekt/m-blk2.txt >D >Dx
Plovoucí blok - aplikace
blok s aplikací "Zonerama": --- detaily^
>blok Nadpis bloku ============ >o-zonerama identifikátor adresa-alba === /a_autor alba_a/ >--
blok s aplikací videa "YouTube": --- detaily^
>blok-x >okno-youtube zkopírovaný a upravený kód z YouTube === ... komentářový text ... >--
varianta jako blok vcelku:
>blok-yt zkopírovaný a upravený kód z YouTube >--
blok s aplikací "Mapy.cz": --- detaily^
>blok Nadpis bloku ============ >okno-mapycz zkopírovaný a upravený kód z Mapy.cz === komentář nebo další prvky dle potřeby >--
pro aplikaci "rajce.idnes.cz": --- detaily^
je výhodné použít vlastní řešení, které umožňuje i start od určitého obrázku - např.:
>blok Nadpis-bloku ============ >os-w adresa-obrázku startovací-adresa-z-horní lišty >--
Obrázky - detaily^
obrázek "na šířku" s velikostí dle šířky bloku/okna:
>os adresa-obrázku
varianta se skutečnou velikostí po kliknutí:
>os-o adresa-obrázku
varianta s otevřením odkazu po kliknití:
>os-w adresa-obrázku adresa-odkazu
shodné varianty pro obrázky "na výšku" 60%:
>ov >ov-o >ov-w
Plovoucí/úvodní obrázky
náhled s volitelnou šířkou XXX v px:
>ou -,XXX,adresa-obrázku
varianta otevírací = otevření obrázku po kliknutí:
>ou-o -,XXX,adresa-obrázku
varianta odkazovací = otevření odkazu po kliknutí:
>ou-w XXX adresa-obrázku adresa-odkazu
Všechny obrázky i odkazy jsou běžně otevírány v nové záložce. Výška obrázků pro zmenšené zobrazení je odvozena od jejich skutečných rozměrů, takže obrazový pás ji nemusí mít celý stejnou.
Retro-náhledy obrázků s pevnými rozměry
Otevírací náhledy, které je možno na stránku skládat po řádcích s prokládanými texty: --- příklad
varianty s výškou 100 nebo 240px:
>on1-o nebo >on2-o adresa-obrázku
varianty 240x360, 225x300, 360x240, 300x225, 300x300 :
>on23-o >on23m-o >on32-o >on32m-o >on33m-o
běžný text a svisle odsazený odstavec:
>tx textový-parametr >txo textový-parametr
Texty a oddělování - Běžné texty a komentáře^
Textový-parametr je úsek textu, zadaný jako 1 řádek nebo jako /+několik řádků+/ , který může obsahovat různé f-značky, včetně odkazů |: adresa-odkazu :|: text-odkazu :|.
odřádkování, odřádkovaný text,300-znakový pevný rastr
řádek-odstavec, záčátek(a) a konec(z) odstavce,
velký mezerový odstavec:
>r >rt textový-parametr >r300 >ro >roa >roz >romtenká černá linka, tučná hnědá linka, mezera:
>l >lth >mSpeciální příkazy pro Bloky s pevným textem^ :
>, >:, >1 řádky pevného textu <
Odkazy v různých variantách - .. Odkazy ..^
odkaz-1, odkaz-2 text-za
odkaz-3 text-za, text-před odkaz-4 text-za,
web text-1 web text-2
web text-3 web text-4
Vymezení změny v otevírání odkazů - /^X---/^
>trw standardní odkaz v nové záložce https://www.zsmodrice.org /^X >trw odkaz ve stejném okně https://www.zsmodrice.org /^ >trw standardní odkaz v nové záložce https://www.zsmodrice.org
web standardní odkaz v nové záložce
web odkaz ve stejném okně
web standardní odkaz v nové záložce
<< vzory pro odkazy vlevo
>ro >w -,odkaz-1,(__) adresa-odkazu >wk odkaz-2 adresa-odkazu text-za >rw -,odkaz-3,(_)text-za(__) adresa-odkazu >kw -,text-před,odkaz-4,(_)text-za(__) adresa-odkazu >l
>trw text-1 adresa-odkazu >txw text-2 adresa-odkazu >wtr adresa-odkazu text-3 >wtx adresa-odkazu text-4
Odkazy lze zadávat i s pomocí f-značek.
Odkaz otevíraný v nové záložce a ve stejném okně:
|: adresa-odkazu :|: text-odkazu :| |: adresa-odkazu .|: text-odkazu :|
Odkaz - vnořené okno
90-50 = šířka-výška v procentech okna/bloku,
tato stránka je >An = neomezená výška bloku
>okno-90-50 adresa-odkazu
adresa-odkazu
Navigační lišta v redakčním systému
Všechny odkazy se otevírají ve stejném okně.
>nl0 -,ZŠ Modřice,http://www.zsmodrice.org/ -,sekce,koment >nl1 -,text,odkaz,rubrika,koment >nl2 -,text,odkaz-1,odkaz-2,stránka,koment
ZŠ Modřice > sekce ^^^ koment
text > odkaz > rubrika ^^^ koment
text > odkaz-1 > odkaz-2 > stránka ^^^ koment
Automatické doplňování odkazů - http..
Pro automatické doplňování odkazů je třeba v úloze nastavit prováděcí příkaz "http ..".
V návrhu stránky je pak potřeba pomocí >http---<http vymezit řádky, ve kterých bude PŘED řádek, začínající "http.." přikopírován aktuálně nastavený vkládací příkaz - např. >wtx, >wtr nebo jiný.
V rámci kopírování jsou vymezovací příkazy v návrhu stránku smazány, v úloze je třeba příslušný příkaz vypnout.
>http adresa-odkazu-1 adresa-odkazu-2 ... <http
Moduly návrhů v Mw-jazyku - >&..
Návrh stránky v Mw-jazyku se může skládat z více dílčích částí = modulů.
Skládání funguje obecně, takže i moduly mohou být složeny z dílčích modulů, ale nesmí v nich být příkaz na některý z nadřízených modulů (!!!). Nedodržení tohoto pravidla způsobí zacyklení generátoru, které je hlášeno v protokolu.
Vzor speciálního příkazu pro vložení modulu, případně může být vkládán se změnou - parametr "z":
>&txt/slozka/m-jmeno.txt >&txt/slozka/m-jmeno.txt z
Pro moduly jsou doporučena jména "m-jmeno" a měly by mít řádek povinného záhlaví dle vzoru.
Pokud je modul vkládán s parametrem "z", může na některých řádcích obsahovat specializovaný komentář, ve kterém je zadaná "změna" řetězce znaků v nich:
<! &---m-jmeno > ... řádky návrhu ... řádek se změnou <! z,starý,nový, > ...
Moduly šablon v HTML/CSS
V rámci dalšího vývoje stavebnice jsou ověřovány též moduly šablon, tj. že určitá HTML/CSS šablona může být vícekrát využita v jiné šabloně - bližší informace poskytne autor na vyžádání.
Moduly ve výsledném kódu HTML/CSS
V rámci dalšího vývoje stavebnice je ověřována též možnost vícekrát využít určitou část HTML/CSS kódu ve výsledníé stránce - bližší informace poskytne autor na vyžádání.
Úvod do programování počítačů (skripty Windows a Python)
Při uvolnění beta-verze stavebnice Mini-web pro uživatelské ověřování (září 2023)
je nabízeno Stručné seznámení s programováním a jazykem Python,
které obsahuje vše potřebné k zahájení praktických programátorských pokusů.