Dotaz: Prezento-publikační nástroj

[GeBu]

Ahoj, hledám nástroj na učební materiály (už roky), které mimo textu obsahují: obrázky, schémata, diagramy, grafy (většinou lokálně uložených, snažím se, aby byly v SVG) a vzorce. Občas nějaká tabulka. Zatím jsem nebyl s ničím úplně spokojen. Požadavky:

• Rozumná složitost práce: Nové věci jsem ochoten se učit, když to bude stát za to, ale mám určité limity.
• Editovatelná forma + něco pro žáky: Původně jsem posílal PDF, ale dneska něco webového.
• Zautomatizovaný proces: Abych nemusel po každé změně složitě generovat výstup.
• (Text i prezentace dohromady: Velice by se mi líbilo, kdyby to byl text i prezentace dohromady. Umím si představit systém, kde bych text psal jako prezentaci a určitý styl bude něco jako body v prezentaci. V textu by se tento styl choval jako nadpis menší úrovně. Určitě by to znamenalo dost o textu dopředu přemýšlet, ale možná by to stálo za to.)
• MS Windows: Jsem nucen používat z pracovních důvodů.

Trochu ty požadavky popíšu na tom, co mi vadí na tom, co jsem už zkoušel:

• MS Word (před 20 lety): Fungovalo to, ale ve Windows se musela doinstalovat PDF tiskárna. Dnes už Word používám, jen pokud musím.
• OpenOffice.org: V něm se mi pracuje nejlíp - maximálně mi vyhovují vzorce. Multiplatformní, vestavěný export PDF. Ale nějak jsem nedotáhl export do HTML.
• On-line editory (MS, Google): MS jsem nikdy nezkoušel a nechci. Aktuálně používám právě GDokumenty s nastaveným sdílením ven - žákům pošlu odkaz. Ale možnosti formátování jsou slabé a nejhorší jsou vzorce. také neumí SVG obrázky a musím generovat PNG.
• Zim: Kdysi jsem zkoušel a pár věcí v tom napsal. Nějak jsem to nedotáhl. Už nevím proč.
• HTML: Na psaní takového materiálu přím v kódu nepřehledné a nepohodlné.
• Latex: Taky mi připadá nepřehledný a slžitostí mi připadá za hranou.
• Značkovací jazyky: Uchvátil mne ASCIIDOC (vzled dokumentů, způsob formátování), ale potřeboval bych live náhled. Editor Atom (ve Windows) vyhovuje, ale nemá live náhled vzorců :( - podpořil jsem požadavek ve fóru na implementaci zadaný v roce 2015 :(.
• Lokální wiki: Trochu komplikované a jak ji pak dostanu ven? Chtěl bych to mít funkční i bez přpojení.

Jsem spíš pokročilý uživatel počítače než nějaký kodér. Chybí mi přehled a každé zkoumání mne stojí dost času. A proto je určitá level, za kterou nechci jít - do této kategorie zatím řadím Latex. Tak zkouším, jestli mne třeba někdo neposune.

Odpovědi

[Jendа]

Lokální wiki: Trochu komplikované a jak ji pak dostanu ven? Chtěl bych to mít funkční i bez přpojení.

DokuWiki drží všechno v textových souborech, které můžeš synchronizovat (rsync, git…), a pro její provoz stačí PHP bez čehokoli dalšího (hmm, teď mě napadá, že pro matematiku je asi potřeba latex, ale prej to funguje s portable verzí webserveru pro Windows). Současně by to elegantně řešilo to „text i prezentace dohromady“, protože v tom textu můžeš mít nějaké vlastní značky (nebo prostě jenom prohlásíš, že seznamy/nadpisy do x-té úrovně jsou body do prezentace a obrázky nějak označené patří k nim) a vygeneruješ z toho třeba kód pro Beamer. Jako studenta by mě pak potěšila ta revision history, se kterou wiki/git nativně přichází -- stávalo se mi, že vyučující ladil učebnici za běhu, vždycky jenom pověsil na web nové PDF, a nebylo jasné, jestli si mám nějakou kapitolu přečíst znovu protože se třeba výrazně změnila.

[GeBu]

Díky za povzbuzení tímto směrem a konkrétní poznámky, jak to udělat. Právě věci jako PHP apod. mi nejsou moc blízké. Ale uvidíme.

[OldFrog {Ondra Nemecek}]

Kdo to bude používat - jenom vy anebo i studenti, kolegové apod.?

Zaměřil bych se na Markdown https://github.com/cben/mathdown/wiki/math-in-markdown Řada editorů má live preview. Má širokou podporu v různých nástrojích a uživatelskou základnu, je docela flexibilní. Výsledky nejsou vizuálně perfektní, ale přijatelně dobré. Výhoda je, že s dokumenty tím pracujete jako s kódem, takže můžete nasadit podobné postupy jako při správě kódu (verzování, balíčkování, porovnávání verzí atd).

TeX je taky samozřejmě hodně zajímavá možnost. Pokud jde hlavně o matematiku + techniku a současně nechcete psát přímo TeX, koukněte na TeXmacs https://www.texmacs.org/tmweb/home/welcome.en.html Je to hodně působivý software s dobrou historií (není založen na TeXu, je to jiná implementace). Koukněte na něj.

[GeBu]

Budu to používat jenom já. Žáci budou konzumenti obsahu a kolegové o tom vůbec nebudou vědět.

Je možné, že u Markdownu nakonec skončím, protože do editoru Atom existuje balíček Markdown Preview Plus (MPP), který vzorce umí. Kdyby existoval stejný balíček pro ASCIIDOC, tak tato diskuse vůbec nevznikla. Vždycky když jsem Markdown zkoušel, tak mi přišlo, že má málo možností. V tomto smyslu mi ASCIIDOC přišel lepší. Ale nikdy jsem Markdown nevyzkoušel pořádně.

Ten TeXmacs je hodně zajímavý. Díky za tip. Používáš ho? Všechna data jsou v jednom souboru?

[OldFrog {Ondra Nemecek}]

Nepoužívám, nemám pro to využití. Píšou

Documents can be saved in TeXmacs, Xml or Scheme format and printed as Pdf or Postscript files. Converters exist for TeX/LaTeX and Html/Mathml.

Dokument může obsahovat živě generované výstupy z jiných programů, je potřeba nastudovat, co je persistentní a co se nově generuje. Obrázky budou asi linkované z disku a zda je možné i embedování nevím.

[GeBu]

Díky za tipy i budoucí (mockrát mne rady tedy ve fóru posunuly). Začal jsem ty věci zkoušet. Zatím mi nejvíc sedí AsciiDoc. Sice jsem narazil na pár problémů (Atom neumí pracovat v AsciiMath, podobně jako GitLab, který jsem chtěl použít - viz můj jiný dotaz), ale vypadá to, že celkově mi sednul.

Co se mi opravdui líbí:

• Značky jsou velmi intuitivní včetně AsciiMath - asi mi tato úroveň složitosti sedla. U LaTeXu bych musel do dokumentace častěji.
• Značky mne v textu neruší - čte se mi to skoro stejně dobře, jako normální text.
• Podpora SVG - to je dáno tím, že výsledkem je web. Ale třeba GDokumenty SVG obrázky neuměly.
• Linkování obrázků z netu - musím se naučit je správně citovat.
• Oproti wiki jednodušší instalace, i když Markdown by byl mnohem jednodušší.
• Neřeším vzhled a přesto výsledek vypadá dobře.
• Vypadá dobře na mobilu.

Nevýhody:

• Menší podpora oproti Markdown v nástrojích a systémech, ale nakonec jsem vše potřebné pořešil.
• Že to všechno není jeden soubor jako v OpenOffice.org, ale to je myslím o zvyku.

[jiwopene]

Příloha:

• vystup.html (628 bytů)

Mě ještě napadá použít Pug pro generování statického webu. Je to značkovací jazyk (nadstavba HTML), který podporuje mj. mixiny (předpřipravené kousky kódu – „funkce“). Syntaxe je ve stylu YAMLu. Chtělo by to ale dopsat styly a případně Makefile pro automatické generování a balení do archívů pro offline užití.

Příklad:

./clanky/jmeno.pug

extends ../sablona

block clanek
  +hlavicka('Odpověď na základní otázku', '2019-04-02')

  p.
    První odstavec
    na dva řádky.

  p
    | Druhý s jinou syntaxí.
    | Druhý řádek se zde také
    | spojí s předchozím.

  ul
    li  První položka
    li  Druhá

  table
    tr
      th  Tabulka jako
      td  v HTML.

./sablona.pug

mixin hlavicka(nazev, datum)
  header
    h1=nazev
    h2=new Date(datum)

doctype
html(lang='cs')
  head
    meta(charset='utf-8')
    title=title || 'Nepojmenovaná stránka'

  body
    nav
      a(href='.') Hlavní stránka
      a(href='./jmeno.html')

    main
      article
        block clanek

    p=`Vygenerováno ${new Date()}`

Výstup v příloze.

[GeBu]

Díky.

[RostaK]

Celkem v pohode je RevealJS ma pomerene jednoduchou ucici krivku a profik oceni ze si pises rovnou v HTML kodu takze udelas co chces. Kdo chce klikatko a editor tak ma k dispozici nastroj Slides, pozor bude te chtit nalakat na placenou verzi, ale je i free verze