The best-known static site generator, Jekyll, was created eight years ago. That was a long time ago in tech years, yet many documentation specialists still don’t know about it. This established technology is a game changer for building documentation portals. Thanks to Jekyll, only the sky is the limit.

1. STATIC SITE GENERATORS
THE GAME CHANGERS
Created by /
Working in
Lukasz Gornicki @derberq
SAP Hybris

2. The Definition

3. Tool that takes your input data, injects
it in a predefined layouts and
generates a final output files that you
can later expose.

4. Tool that takes your input data, injects
it in a predefined layouts and
generates a final output files that you
can later expose.

5. STATIC SITE GENERATOR
word by word

6. STATIC
Static Web Page
Not dynamic
No server side rendering

9. SITE
Web Page

10. GENERATOR
Takes input and gives output
Input can be anything, like markdown
Output can be anything, like HTML

11. STATIC SITE GENERATORS

12. AVAILABLE GENERATORS

13. - 457
"All" possible programming languages
https://staticsitegenerators.net
https://www.staticgen.com

14. KNOWN IMPLEMENTATIONS

15. ONGITHUB DEVELOPER NANOC

16. ONBOOTSTRAP JEKYLL

17. ONKUBERNETES FROM GOOGLE JEKYLL

18. ONPROMETHEUS FROM SOUNDCLOUD NANOC

19. ONYAAS DEV PORTAL DOCPAD

20. INNOVATIVE, CLOUD, OPEN SOURCE, STARTUP

21. HTTPS://GITHUB.COM/DERBERG/AWESOME-DOCS-WITH-STATIC-SITE-GENERATORS

22. SSG VS DITA

23. DITA is an XML based standard

24. SSGs are tools that generate output basing on a given input

25. Static Site Generators vs DITA Open Toolkit
Markdown/AsciiDoc/reStructuredText vs DITA

26. CONTENT REUSE
DITA: conref
conref="../reusables/topics/reusables-importing-data.dita#reusables-importing-data/smart-pa
SSG: includes (jekyll) or partials (docpad and hugo)
<%- @partial('feedback_url') %>

27. METADATA
DITA: used for indexing
SSG: managing and identifying a document
In DocPad doesn't have to be explicitly set in file
---
title: My blog post about cats
tags:
- animal
---
your content written in **Makrdown** or <strong>HTML</strong>

28. MAPS - RELATIONSHIP TABLES
DITA: ditamap and map element
SSG: docpad-plugin-related and tags metadata

29. INFORMATION TYPING
DITA: default like glossary or task + anything through specialization
SSG: through metadata and folder structure
---
title: Creating an object
type: Tutorial
---

30. SPECIALIZATION
DITA: possible
SSG: possible

31. DITA
DITA is a standard/specification
You need Ixiaso or Oxygen as a CMS
DITA open toolkit for generation
Static Site Generators
Toolkit that does a generation
Markdown
Syntax specification.
WHAT IS MY MESSAGE ANYWAY

32. CAN STATIC SITE GENERATORS AND DITA COEXIST?

33. ---
title: 'Wallet Configuration'
order: 10
---
<div>
<section class="future" aria-hidden="true" style="display: block;
<div>
<p>A Marketer can configure Apple Wallet and Google Wallet to cre
and coupons.
</p>
<p>A loyalty administrator must provide Apple Wallet and Google W

34. SSG ADVANTAGES AND DISADVANTAGES

35. DISADVANTAGES
generation performance

36. ADVANTAGES?
huge amount to choose from
all type of programming languages
open source
flexible and extensible
cms agnostic
git challange for TWs
learning through samples
crowd sourcing

37. SHOULD I USE IT?

38. WHO ARE YOU?

39. TECHNICAL WRITER / INFORMATION DEVELOPER /
CONTENT PROVIDER

40. BUSINESS DECIDER / DOCUMENTATION MANAGER /
STRATEGIEST / ARCHITECT

41. SSG NEXT STEP

42. PROBLEM
vsSlate DocuApi

43. CONTENT AS A SERVICE
vsPresentation Layer Content

44. THANKS!
REST API Docs Guidelines:
This presentation:
GitHub:
Twitter:
DocPad:
reveal.js:
https://github.com/YaaS/REST_API_Documentation_Guidelines
https://github.com/derberg/staticsitegenerators_gamechangers
derberg
@derberq
https://docpad.org/
https://github.com/hakimel/reveal.js