Text of wiki.squid-cache.org โ€บ SysAdmin โ€บ ProgrammingGuide as Styx crawled it on Nov 18, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

How the Programming Guide is built | Squid Web Cache wiki

๐Ÿ”— How the Programming Guide is built ๐Ÿ”— The data The main contents are in the https://github.com/squid-cache/programming-guide.github.io github repository, and are published via github pages, at address https://programming-guide.squid-cache.org/ The pages are automatically refreshed daily from a checkout of the squid sources by a github workflow . The doxyfile in the squid sources is not used, as it is stricly tied to the version of the programming guide which is embedded in the squid main site.

This unfortunately means that the graphic theme doesnโ€™t match the squid site. In order to preserve links and references, apache redirect rules are in place via mod_rewrite in master.squid-cache.org.conf to ensure that there are no dangling links. In order to be able to publish the github pages site, the automations need to rely on the PUSH_TOKEN repository secret, which needs to be refreshed at least once a year. ๐Ÿ”— Transitional measures The squid main site still contains the full programming guide, and itโ€™s still refreshed daily from the sources.

It is not however served, as it is masked by the redirect to the github pages. Once we are fully satisfied that itโ€™s no longer needed, we can remove the generation logic, the copy of the contents, and the related configuration files in the squid sources. Navigation: Site Search , Site Pages , Categories , ๐Ÿ”ผ go up