Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Provide a method for contributing HTML snippets / code #48

Open
occupant opened this issue Jan 23, 2020 · 1 comment
Open

Provide a method for contributing HTML snippets / code #48

occupant opened this issue Jan 23, 2020 · 1 comment

Comments

@occupant
Copy link
Contributor

occupant commented Jan 23, 2020

Problem
We need a way to accommodate contributed HTML, both in terms of documentation and outputting code / pages.

This HTML format should be a superset of HTML so as not to impede novice users (if they want to just write HTML, we shouldn't discourage that).

Should allow the use of includes / nested templates so that code can be isolated and reused.

Proposed Solution

Twig

Alternatives considered
Plain HTML - poor choice due to high maintenance cost, error prone
Markdown - poor choice due to limits of class / attribute additions
Pug / Jade - poor choice due to not being easy to use plain HTML

Additional context
Happy to consider any other alternatives - these are just the ones I'm most familiar with.

@occupant occupant changed the title Provide a method for contributing HTML snippets Provide a method for contributing HTML snippets / code Jan 23, 2020
@hazuremon
Copy link
Member

Team have reviewed multiple static site generator options (15+) and have identified Gatsby as potential candidate as the tool. Next step is to explore and prototype Gatsby in more detail as the go to tool.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

No branches or pull requests

2 participants