{"id":14989894,"url":"https://github.com/curl/curl-www","last_synced_at":"2025-12-16T19:06:38.922Z","repository":{"id":8332289,"uuid":"9886415","full_name":"curl/curl-www","owner":"curl","description":"The curl.se website","archived":false,"fork":false,"pushed_at":"2025-04-08T09:22:46.000Z","size":68717,"stargazers_count":103,"open_issues_count":3,"forks_count":95,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-04-09T22:29:51.822Z","etag":null,"topics":["curl","documentation","html","libcurl","website"],"latest_commit_sha":null,"homepage":"https://curl.se/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/curl.png","metadata":{"files":{"readme":"README.md","changelog":"changes.t","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"security.txt.in","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-05-06T12:36:58.000Z","updated_at":"2025-04-08T09:22:50.000Z","dependencies_parsed_at":"2024-03-12T08:49:30.261Z","dependency_job_id":"1ab6d674-a13d-4562-b7fe-0f348f1d876d","html_url":"https://github.com/curl/curl-www","commit_stats":{"total_commits":6188,"total_committers":67,"mean_commits":92.35820895522389,"dds":0.1268584356819651,"last_synced_commit":"40d374312fd508bef47144eef0c60bc6117a496c"},"previous_names":[],"tags_count":94,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/curl%2Fcurl-www","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/curl%2Fcurl-www/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/curl%2Fcurl-www/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/curl%2Fcurl-www/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/curl","download_url":"https://codeload.github.com/curl/curl-www/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248639255,"owners_count":21137811,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["curl","documentation","html","libcurl","website"],"created_at":"2024-09-24T14:19:05.943Z","updated_at":"2025-12-16T19:06:38.903Z","avatar_url":"https://github.com/curl.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# curl-www\n\nThis is (most of) the curl.se website contents. It mostly builds static\nHTML files that are preprocessed.\n\n## Prerequisites\n\nThe website is a on old custom made setup that mostly builds static HTML\nfiles from a set of source files using (GNU) `make`. The sources files are\npreprocessed with what is basically a souped-up C preprocessor called `fcpp`\nand a set of `perl` scripts. The man pages get converted to HTML with\n`roffit`.\n\nMarkdown is converted to HTML with `pandoc`.\n\nMake sure the following tools are in your $PATH.\n\n - curl\n - [fcpp](https://daniel.haxx.se/projects/fcpp/)\n - GNU date\n - GNU enscript\n - GNU make\n - pandoc\n - perl (with CPAN packages: CGI, HTML::Entities)\n - [roffit](https://daniel.haxx.se/projects/roffit/)\n - zip\n\n## Build\n\nOnce you have cloned the Git repo the first time, invoke `sh bootstrap.sh` once\nto get a symlink and some initial local files setup, and then you can build the\nwebsite locally by invoking make in the source root tree.\n\nNote that this does not make you a complete website mirror, as some scripts\nand files are only available on the real actual site, but should give you\nenough to let you load most HTML pages locally.\n\n## A local curl build\n\nThe bootstrap script creates a `cvssource` entry in the web root directory. In\nthat directory you should do an in-tree build of curl. This build renders a\nrange of artifacts (documentation mostly) that the website build references.\n\nIf you forget to do the curl build, building the website will fail due to\nmissing files.\n\nA minimal non-TLS build is perfectly fine. Like this:\n\n    autoreconf -fi\n    ./configure --without-ssl --without-libpsl\n    make\n\n## Edit the web\n\n[Web editing guidelines](https://curl.se/web-editing.html)\n\n# curl.local\n\nTo run a local copy of the curl website, have a local Apache or python\nto serve `curl.local` on `127.0.0.1`. Add this line to `/etc/hosts`:\n\n    127.0.0.1 curl.local\n\n## Apache httpd config\n\nA config file for apache2 to run a virtual server for `curl.local` on your\nlocal machine might look like this:\n\n~~~\n\u003cVirtualHost *:80\u003e\n    ServerName curl.local\n    ServerAdmin [my email address]\n    DocumentRoot [full path to the curl-www build]\n\n    ErrorLog ${APACHE_LOG_DIR}/curllocal-error.log\n    CustomLog ${APACHE_LOG_DIR}/curllocal-access.log combined\n\u003c/VirtualHost\u003e\n\n\u003cDirectory [full path to the curl-www build]\u003e\n   Options Indexes Includes FollowSymLinks ExecCGI\n   AllowOverride All\n   AddHandler cgi-script .cgi\n   Require all granted\n\u003c/Directory\u003e\n~~~\n\n## Python3\n\nFrom the directory containing the website, run:\n\n    python3 -m http.server --cgi -b curl.local 8000\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcurl%2Fcurl-www","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcurl%2Fcurl-www","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcurl%2Fcurl-www/lists"}