Teksteditor

• een computerprogramma waarmee onopgemaakte digitale tekst bewerkt kan worden. Een teksteditor wordt onderscheiden van een tekstverwerker, die tot doel heeft om opgemaakte tekst te maken.
• een noodzakelijke tool als je schrijft voor het internet
• zal helpen bij de html en css opdracht (plugins)
  • highlighting code
  • plugins
• Atom
• sublime text (met plugins marked, evernote, pandoc, git)

formaat: platte tekst

• In de informatica wordt met platte tekst bedoeld tekst die uitsluitend bestaat uit letters, spaties, cijfers en leestekens.
• Tekst die is voorzien van opmaak (vet, cursief, onderstreept, sub- en superscript alsook tabellen en afbeeldingen) is geen platte tekst.
• Een aantal opmaaktekens zoals regelovergang (carriage return/line feed) en tabstop komen in platte tekst wel voor.

voordelen van platte tekst

1. kan gelezen worden door elke computer
2. kan gescynchroniseerd worden op al je toestellen
3. kan naar zo goed als elk ander formaat worden omgezet (pandoc)
4. is gegarandeerd in de toekomst nog leesbaar (beantwoordt aan de standaarden van langetermijnbewaring)
5. is makkelijk te lezen en catalogiseren
6. is een handig formaat voor datamining
7. is een uitstekend formaat voor versiebeheer

Markdown

• is geen taal of programma, enkel een conventie om semantische eenheden in een tekst aan te duiden, met eenvoudige syntax:

  • kanonieke specificatie
  • CommonMark Spec

• Markdown is een de facto standaard voor online schrijven geworden

• Writing in this way liberates the author from the tool - je kan schrijven met eender welke editor (own your data)
• Een markdown bestand kan als moederbestand dienen voor een breed gamma van documentformaten: wetenschappelijke artikels, wikis, syllabi, blog posts ...
• leer Markdown kennen

Markdown toepassingen

• contentmanagementsystemen zoals wordpress en drupal hebben markdown filters
• er is ook de markdown here extensie voor browser en gmail
• mailmate is een e-mail client (Mac OS X) met ondersteuning voor markdown
• je kan ook met een online markdown editor zoals stackedit of Markable.in werken. Een workflow met de eerste: 'A simple way to write, edit, and publish documentation online using Google Docs and Markdown')
• coggle, maak mindmaps met markdown
• trello, projectmanagement
• interactieve notebooks verstaan markdown
• paketten om statische websites te genereren zoals jekyll kunnen zeer goed om met markdown input

Pandoc

• pandoc.org

Treat you source files as an authoritative version of your text, and you target files as disposable “print outs” that you can easily generate with Pandoc on the fly.

• CLI

$ pandoc -f html -t markdown http://informatiewijzer.be/module/schrijven_voor_het_web -o 20180216-mdtest.md

• omzetten naar pdf via pandoc met weergave van

  • toc (inhoudsopgave)
  • voetnoten
  • bibliografische referenties
  • $ pandoc -S -o writing_workflow.pdf writing_workflow.md -V geometry:margin=1in -N --toc --filter pandoc-citeproc

• maak van je markdown bestand een presentatie met reveal.js

• maak van je markdown bestanden een statische website

  • met jekyll of mkdocs
  • combineer jekyll and reveal.js

Starting off in Markdown with Word-to-Markdown: [Word to Markdown Converter(https://github.com/benbalter/word-to-markdown)

If there’s one thing I’ve learned trying to convert Word documents to Markdown, it’s that Markdown is not an alternative to traditional desktop formats. It’s an entirely different animal. It’s both machine- and human-readable, but more importantly, it forces you to author content openly, semantically, and for an internet-based world.

Next time you begin a new project for which the internet, not paper is the primary output, think twice before firing up that desktop publishing platform. You’ll gain more than mere semantics.

Atom

• Atom Flight Manual
• packages
• Cmd+Shift+P = Command Palette; Ctrl+Shift+P in windows

html

• language-html package met ondersteuning voor HTML syntax highlighting in de vorm van snippets die je snel tags laten aanmaken
• bijvoorbeeld html - tab
• To see all the available snippets for the file type that you currently have open, choose "Snippets: Available" in the Command Palette.

css

• language-css
• installeren via command palette - settings view