htacg / htacg.github.io

HTACG Homepage

README for HTACG GitHub Pages

This repository consists of the HTML Tidy Advocacy Group (HTACG) homepages.

For ease of maintenance by multiple contributors HTACG's GitHub pages take advantage of GitHub’s Jekyll integration. Therefor it is necessary to be slightly familiar with Jekyll and GitHub’s implementation of Jekyll in order to make changes to our sites.

References

Everything you need to know about Jekyll can be found on jekyllrb.com.

About Github and HTACG Pages

The HTAGC group main project page is served from files located in https://github.com/htacg/htacg.github.io. It can be reached from http://www.htacg.org or http://htacg.github.io. The latter is the standard means of accessing the project page, however the former works because we've set up a domain name and configured GitHub to use the domain name via the CNAME file in the repository.

HTACG Project pages are available as subdirectories of the HTACG domain, for example:

• http://www.htacg.org/html-tidy
• http://www.htacg.org/binaries
• etc.

In general this is intuitive behaviour of GitHub pages but it can cause some issues with relative paths used for project web pages. For example:

The HTML-Tidy main project page is served from files located in https://github.com/htacg/tidy-html5/tree/gh-pages. It can be reached from http://www.html-tidy.org, or as above, from http://www.htacg.org/html-tidy.

This is where resource paths can be an issue. Thus it's important to follow the advice given on Jekyll's site. This will ensure that resources such as stylesheets and images are served from the appropriate directory.

In summary use the site.baseurl variable as described in the linked document, and when performing local previewing start Jekyll's server with:

jekyll serve --baseurl ''

or

bundle exec jekyll serve --baseurl ''

Specifying the baseurl on the command line will override the base URL set in _config.yml.

htacg.github.io's Issues

Tidy, BBedit, Firefox

Running Macos Sierra, I installed Tidy yesterday. Looking at it briefly, it I get the impression that both BBEdit and Firefox call it to do their HTML checking. If this is true, it seems that there is no incentive for me to learn to use Tidy directly, and that these applications will automatically use the new version. It might save newbies a lot of thrashing if the ReadMe mentioned this fact.
Is it indeed a fact?

Redirect old tidy web site URL

The tidy web site used to be accessible at http://www.htacg.org/tidy-html5/; now that's 404 not found. Please add a redirect to the new web site http://www.html-tidy.org. It looks like 106632f tried to do this but it was undone in 4394629. I don't care how you do it, but it is imperative for the proper functioning of the web that old URLs do not go 404.

JPEG artifact

everywhere