{"id":26447530,"url":"https://github.com/z0u/cargo-web","last_synced_at":"2025-03-18T13:57:28.707Z","repository":{"id":75882838,"uuid":"42817223","full_name":"z0u/cargo-web","owner":"z0u","description":null,"archived":false,"fork":false,"pushed_at":"2015-09-22T02:55:09.000Z","size":13108,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-08-07T10:56:44.258Z","etag":null,"topics":[],"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/z0u.png","metadata":{"files":{"readme":"README.rst","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}},"created_at":"2015-09-20T15:04:01.000Z","updated_at":"2015-09-20T15:08:05.000Z","dependencies_parsed_at":"2023-03-11T20:44:04.835Z","dependency_job_id":null,"html_url":"https://github.com/z0u/cargo-web","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z0u%2Fcargo-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z0u%2Fcargo-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z0u%2Fcargo-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z0u%2Fcargo-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/z0u","download_url":"https://codeload.github.com/z0u/cargo-web/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244236086,"owners_count":20420753,"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":[],"created_at":"2025-03-18T13:57:28.006Z","updated_at":"2025-03-18T13:57:28.701Z","avatar_url":"https://github.com/z0u.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"The Cargo Website\n=================\n\nFor better or worse, this is a website built with the Pelican static website\ngenerator.\n\nPut standard pages in the `content/pages` directory as Markdown or\nreStructuredText. Put blog entries at the root of `content`. These are then\nturned into HTML by Pelican and dumped into the `output` directory.\n\nThe custom HTML on the home page as well as the other branding and CSS is in\n`themes`.\n\nInstalling requirements\n-----------------------\n\nThere are a few steps you'll need to perform once to work with this website::\n\n1. Install the required system packages::\n\n       $ sudo apt-get install fabric python-pip python-virtualenv \\\n         virtualenvwrapper ruby ruby-dev fontforge ttfautohint woff-tools\n       $ sudo gem install fontcustom\n\n   TODO: Update instructions to use RBM or so instead of global install.\n\n2. We'll install the relevant Python packages into a virtualenv. You can do this\n   using the standard `virtualenv` command, but `virtualenvwrapper` makes it a\n   little easier by providing the `mkvirtualenv` and `workon` commands.\n\n   Create a Python virtual environment to store downloaded packages in::\n\n       $ virtualenv cargo\n\n3. Now activate the virtual environment::\n\n       $ . cargo/bin/activate\n\n4. Download and install the required Python packages::\n\n       (cargo)$ pip install -r requirements.txt\n\n   This refers to the `requirements.txt` file in the website directory.\n\nBuilding the website\n--------------------\n\nBefore you build the website, you need to first activate the virtual\nenvironment as above.\n\nThen we run Pelican to build the static website from your source files. There's\na single command way to do this, but I've found it a bit unreliable.\n\nIn one shell run the command to watch the source files and rebuild the static\npages into the `output` directory::\n\n    (cargo)$ make regenerate\n\nIn another, run the mini web-server that serves the files from `output`::\n\n    (cargo)$ make serve\n\nYou can now browse the site at `http://localhost:8000/`.\n\n\nUploading the website\n---------------------\n\nUse rsync to copy the output directory to the remote web server::\n\n    $ rsync -avz --exclude=releases output/ cargo-web@lille.sturm.com.au:/home/web/cargo/htdocs\n\n\nUploading software releases\n---------------------------\n\nCopy resources to the static/releases directory on the server::\n\n    $ rsync -avz --progress *.zip *.bz2 cargo-web@lille.sturm.com.au:/home/web/cargo/htdocs/static/releases/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fz0u%2Fcargo-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fz0u%2Fcargo-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fz0u%2Fcargo-web/lists"}