Web Concepts: Concepts that matter for the surface of the Web
HTML XSLT CSS Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_includes
_layouts
_posts
_sass
concepts
css
specs
.gitignore
CNAME
Gemfile
Gemfile.lock
JSON-concepts.md
JSON-specs.md
JSON.md
LICENSE.md
README.md
_config.yml
concepts.json
concepts.xml
favicon-16x16.png
favicon-32x32.png
feed.xml
forkme.png
history.html
index.html
transform.xsl
xml2jekyll.xsl
xml2json.xsl

README.md

Web Concepts

This is the repository for the Web Concepts site published at webconcepts.info.

Setup

There probably should be a bit of documentation of how all of this works... A very high-level overview is this:

  • New categories (concepts or specification organizations/series) get added via XML configuration files in those directories.

  • New specification data gets added to the specification source directory as individual XML files. These specification files contain information about the concepts that are defined by the specifications.

  • A new version of the complete site is generated via transform.xsl, which requires an XSLT 3.0 processor. The XSLT script reads all specification XML files, and generates Jekyll-enabled MD files for the complete site. It also generates JSON representations for concepts and specifications.

  • The MD-based Web site is created by letting Jekyll generate a new site from the output of the XSLT processing step.

  • After validating locally that everything looks good, a new version is committed to GitHub, and Jekyll runs there as well as part of the repository setup.

License

Please respect the license.