{"id":17790771,"url":"https://github.com/davorg/perlwebadvice","last_synced_at":"2026-03-05T01:03:09.711Z","repository":{"id":66584817,"uuid":"69572172","full_name":"davorg/perlwebadvice","owner":"davorg","description":"A website containing advice for people writing web applications in Perl","archived":false,"fork":false,"pushed_at":"2025-08-26T07:27:46.000Z","size":50,"stargazers_count":2,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-10-16T08:05:13.706Z","etag":null,"topics":["perl","web-development","web-siite"],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davorg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2016-09-29T13:51:35.000Z","updated_at":"2025-08-26T07:27:44.000Z","dependencies_parsed_at":"2024-10-27T10:56:35.765Z","dependency_job_id":"4b916f18-78cb-4905-8316-34996c950dc6","html_url":"https://github.com/davorg/perlwebadvice","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/davorg/perlwebadvice","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davorg%2Fperlwebadvice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davorg%2Fperlwebadvice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davorg%2Fperlwebadvice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davorg%2Fperlwebadvice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davorg","download_url":"https://codeload.github.com/davorg/perlwebadvice/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davorg%2Fperlwebadvice/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30104218,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T00:38:46.881Z","status":"ssl_error","status_checked_at":"2026-03-05T00:38:45.829Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["perl","web-development","web-siite"],"created_at":"2024-10-27T10:47:55.462Z","updated_at":"2026-03-05T01:03:04.672Z","avatar_url":"https://github.com/davorg.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Perl Web Advice\nA website containing advice for people writing web applications in Perl.\n\nSee [web.perlhacks.com](http://web.perlhacks.com/).\n\n## Development environment\n\nThis web site is developed using a static sitebuilder called\n[`aphra`](https://metacpan.org/dist/App-Aphra/view/bin/aphra). In order\nto contribute to the site, you'll need to have `aphra` installed.\n\n### Install dependencies\n\nThere are two important dependencies for installing `aphra` - `pandoc`\nand `http_this`.\n\n* `pandoc` is a tool for converting between various document formats. We use it for converting between Markdown and HTML. If you're working on Linux, there is almost certainly a pre-build package that you can install with a command like `dnf install pandoc` or `apt install pandoc`. On other operating systems, you should see the [`pandoc` web site`](https://pandoc.org/)\n* `http_this` is a mini web server that you can use to view changes to the web site before pushing them to GitHub and deploying them to the live version web site. It is a CPAN module so you can install it using you favourite CPAN installation tool - for example, `cpanm App::HTTPThis`.\n\n### Install `aphra`\n\n`aphra` is also a CPAN module. So you can install it using a command like `cpanm App::Aphra`.\n\n## Working on the site\n\nThe usual way to work on the code is to create a fork and work on that. You can then\nsend your changes back to us by creating a pull request.\n\n### Fork and clone the source code\n\nThe main copy of the source code is at https://github.com/davorg/perlwebadvice.\nNear the top right of that web page is a button labelled \"Fork\". If you press\nthat button, GitHub will create your own copy of the source code under your\nGitHub account. You can make a local copy of your repo by clicking the big\ngreen \"Clone\" button and copying the URL of your repo. You then open a\ncommand-line terminal and type:\n\n* `git clone [YOUR URL HERE]`\n\nThis will create a new directory called `perlwebadvice` containing a copy\nof the source code.\n\n### Understanding the source code\n\nThere are three important directories in the source code tree.\n\n* `in` contains the actual pages that make up the web site. Each file under this directory will be copied to the live web site. If the filename ends with `.tt` it will be processed with the [Template Toolkit](https://metacpan.org/pod/Template::Toolkit) before being copied to the output directory (which is called `docs`). Any files that don't end with `.tt` are just copied over.\n* `fragments` contains small sections of web pages that are inserted into the main web pages in `in`.\n* `layouts` contains layout templates that are used to control the look and feel of the web pages.\n\n### Testing your changes\n\nOnce you've made some changes, you'll (hopefully) want to test your changes\nbefore sending them back to us. This is a two-stage process:\n\n1. Run `aphra build`. \nThis builds the site and puts a copy of the new version into the `docs` directory.\n2. Run `aphra server`. \nThis runs a local web server allowing you to visit a local copy of the web site at http://localhost:7007/.\n\n### Submitting your changes\n\nOnce you're happy that your changes do what you want (and don't break anything)\nyou can submit them back to the main repo for incorporation into the live site.\n\nTo do this, you need to run `git add` to add any files you've added or changed\nand then `git commit` to commit your changes (this will give you an opportunity\nto provide a description of the changes you've made - please make that\ndescription useful). You can then run `git push` to send the changes back to\nyour copy of the code on GitHub.\n\nYou can then go to the web page at:\n\n* https://github.com/davorg/perlwebadvice/compare\n\nto create a pull request. Leave the \"base repository\" dropdown as it is and\nselect your repo from the \"head repository\" link. The page will then show\nyour changes and (when you're happy you're submitting what you want to\nsubmit) you can submit the pull request. Some time later, we'll look at your\npull request and either accept it or reply with suggestions for improvements.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavorg%2Fperlwebadvice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavorg%2Fperlwebadvice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavorg%2Fperlwebadvice/lists"}