static/markup

markup vs Markdown


WYSIWYG never worked for me...
A long time markup user, HTML immediately attracted for general document formatting, as well as web pages.
Markdown disappoints, for my purposes:
  • Inconsistent implementations across platforms
  • Missing important (to me) features
  • Not IMO simpler than html, once adding refining kludges
  • Daunting (also IMO) theme customization:
    While no fan of CSS syntax, clear separation of theme design from document elements facilitates maintainability.

Employ Web Components for HTML modularity.

Template engines help break HTML code into components for reuse across multiple HTML files.
Template engines also support passing variables into those components.
  • Browseable pages from template engines require compiling, e.g. by client-side JavaScript.
  • GitHub Pages are static;  template engine must run client-side.
  • Since HTML Imports (e.g. <link rel="import" href="/path/to/imports/stuff.html">) is deprecated,
    <template> HTML gets loaded by using <script> to load Javascript, which loads HTML using fetch().

Web Componenent references

  • A Complete Introduction to Web Components in 2023 | Kinsta
  • Web components: The ultimate guide | CREATIVE BLOQ
  • An Introduction to Web Components | CSS-TRICKS
  • Open Source Web Components implemented in vanilla JavaScript
  • JavaScript Web Components
  • Mozilla Web Components
  • Client-side tools
  • web components in separate files
  • Fluent Web Components | Microsoft using React
  • maintained by blekenbleu