Tekst-gebaseerde tools, echt niet alleen voor nerds...

Het lijkt een beetje nerdy maar in deze sessie laat ik je de kracht zien van platte tekst (o.a. markdown). Met behulp van een eenvoudige editor en wat tools maken we:

- een statische website,
- documentatie,
- een presentatie en
- schema's in Confluence

Voordeel van deze tekst-gebaseerde tools is dat deze ook gemakkelijk te combineren zijn met versiebeheer tools zoals Git en daarnaast op alle platformen beschikbaar zijn.

Transcript

1. Tekst-gebaseerde tools,
   Tekst-gebaseerde tools,
   echt niet alleen voor nerds...
   echt niet alleen voor nerds...
   

   View Slide

2. Het lijkt een beetje nerdy maar in deze sessie laat ik je
   de kracht zien van platte tekst (o.a. markdown). Met
   behulp van een eenvoudige editor en wat tools maken
   we:
   een statische website,
   documentatie,
   een presentatie en
   schema's in Confluence
   Voordeel van deze tekst-gebaseerde tools is dat deze
   ook gemakkelijk te combineren zijn met versiebeheer
   tools zoals Git en daarnaast op alle platformen
   beschikbaar zijn.
   

   View Slide

3. Markdown, hoe het begon ...
   Markdown, hoe het begon ...
   

   View Slide

4. Er was eens een prins,
   Er was eens een prins,
   

   View Slide

5. zijn naam was John ...
   zijn naam was John ...
   

   View Slide

6. John Gruber
   John Gruber
   

   View Slide

7. John Gruber
   John Gruber
   "The overriding design goal for Markdown's formatting
   syntax is to make it as readable as possible.
   

   View Slide

8. John Gruber
   John Gruber
   "The overriding design goal for Markdown's formatting
   syntax is to make it as readable as possible.
   The idea is that a Markdown-formatted document
   should be publishable as-is, as plain text,
   

   View Slide

9. John Gruber
   John Gruber
   "The overriding design goal for Markdown's formatting
   syntax is to make it as readable as possible.
   The idea is that a Markdown-formatted document
   should be publishable as-is, as plain text,
   without looking like it's been marked up with tags or
   formatting instructions."
   

   View Slide

10. Markdown
    Markdown
    

    View Slide

11. Markdown
    Markdown
    MultiMarkdown
    MultiMarkdown
    

    View Slide

12. Markdown
    Markdown
    MultiMarkdown
    MultiMarkdown
    CommonMark
    CommonMark
    

    View Slide

13. Markdown
    Markdown
    MultiMarkdown
    MultiMarkdown
    CommonMark
    CommonMark
    GitHub Flavored Markdown
    GitHub Flavored Markdown
    

    View Slide

14. Markdown
    Markdown
    MultiMarkdown
    MultiMarkdown
    CommonMark
    CommonMark
    GitHub Flavored Markdown
    GitHub Flavored Markdown
    Gestandaardiseerd in RFC 7763 (Markdown) en RFC
    7764 (MultiMarkdown, CommonMark en GFM)
    

    View Slide

15. Verschillen ?
    Verschillen ?
    

    View Slide

16. Verschillen ?
    Verschillen ?
    Verschillen !
    Verschillen !
    

    View Slide

17. Verschillen ?
    Verschillen ?
    Verschillen !
    Verschillen !
    Werkbaar ?
    Werkbaar ?
    

    View Slide

18. Verschillen ?
    Verschillen ?
    Verschillen !
    Verschillen !
    Werkbaar ?
    Werkbaar ?
    Werkbaar !
    Werkbaar !
    

    View Slide

19. Markdown & GFM Documentatie
    Markdown & GFM Documentatie
    GitHub
    GitHub Mastering Markdown
    Mastering Markdown
    

    View Slide

20. Markdown online demo
    Markdown online demo
    marked.js.org/demo
    marked.js.org/demo
    

    View Slide

21. Markdown offline demo
    Markdown offline demo
    with TextEdit & Marked 2
    with TextEdit & Marked 2
    

    View Slide

22. View Slide

23. Statische websites via Markdown
    Statische websites via Markdown
    

    View Slide

24. Statische website?
    Statische website?
    

    View Slide

25. Statische website:
    Statische website:
    geen database back-end
    pagina's bestaande uit HTML + CSS
    content is statisch
    betere caching
    betere performance
    veilig
    

    View Slide

26. Voorbeeld sites
    Voorbeeld sites
    tisgoud.nl
    tisgoud.nl
    wheelies.nl
    wheelies.nl
    devNetNoord
    devNetNoord
    

    View Slide

27. Static Site Generators
    Static Site Generators
    StaticGen
    StaticGen
    

    View Slide

28. View Slide

29. Documentatie via MarkDown
    Documentatie via MarkDown
    

    View Slide

30. MkDocs
    MkDocs
    MkDocs is a fast, simple and downright gorgeous static
    site generator that's geared towards building project
    documentation. Documentation source files are
    written in Markdown, and configured with a single
    YAML configuration file.
    

    View Slide

31. MkDocs
    MkDocs
    MkDocs
    MkDocs
    

    View Slide

32. MkDocs with Material theme
    MkDocs with Material theme
    

    View Slide

33. View Slide

34. Presentatie via Markdown
    Presentatie via Markdown
    

    View Slide

35. Reveal.js
    Reveal.js
    Reveal.js
    Reveal.js
    

    View Slide

36. Content slides
    Content slides
    in extern Markdown bestand.
    

    View Slide

37. PlantUML
    PlantUML
    

    View Slide

38. PlantUML
    PlantUML
    PlantUML is an open-source tool allowing users to
    create UML diagrams from a plain text language.
    

    View Slide

39. PlantUML
    PlantUML
    PlantUML is an open-source tool allowing users to
    create UML diagrams from a plain text language.
    The language of PlantUML is an example of an
    Application Specific Language.
    

    View Slide

40. PlantUML
    PlantUML
    PlantUML is an open-source tool allowing users to
    create UML diagrams from a plain text language.
    The language of PlantUML is an example of an
    Application Specific Language.
    It has been used to allow blind students to work with
    UML.
    

    View Slide

41. PlantUML URL
    PlantUML URL
    PlantUML
    PlantUML
    

    View Slide

42. View Slide

43. View Slide

44. View Slide

45. PlantUML Online demo
    PlantUML Online demo
    PlantText
    PlantText
    

    View Slide

46. PlantUML offline demo
    PlantUML offline demo
    

    View Slide

47. PlantUML supported apps
    PlantUML supported apps
    

    View Slide

48. View Slide

49. Bedankt voor jullie aandacht!
    Bedankt voor jullie aandacht!
    wat is jouw volgende stap?
    

    View Slide