{"id":26193359,"url":"https://github.com/samdney/webwml","last_synced_at":"2025-10-26T00:10:20.670Z","repository":{"id":217024936,"uuid":"96637739","full_name":"Samdney/webwml","owner":"Samdney","description":null,"archived":false,"fork":false,"pushed_at":"2018-04-06T03:24:32.000Z","size":111278,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-12T01:40:00.420Z","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/Samdney.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}},"created_at":"2017-07-08T18:47:00.000Z","updated_at":"2018-04-06T02:58:32.000Z","dependencies_parsed_at":"2024-01-14T06:52:04.052Z","dependency_job_id":null,"html_url":"https://github.com/Samdney/webwml","commit_stats":null,"previous_names":["samdney/webwml"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Samdney/webwml","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samdney%2Fwebwml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samdney%2Fwebwml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samdney%2Fwebwml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samdney%2Fwebwml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Samdney","download_url":"https://codeload.github.com/Samdney/webwml/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samdney%2Fwebwml/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281039585,"owners_count":26433815,"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","status":"online","status_checked_at":"2025-10-25T02:00:06.499Z","response_time":81,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-03-12T01:40:06.611Z","updated_at":"2025-10-26T00:10:20.615Z","avatar_url":"https://github.com/Samdney.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# How to contribute\n\nThanks for being interested to work on the website, I tried to make a simple\nhow-to for you to quickly get you setup:\n\n__Step 1:__ Clone the git repo.\n\n    git clone https://git.torproject.org/project/web/webwml.git\n    cd webwml\n\n__Step 1b:__ Create a bare public repository (i.e on Github), where you'd push\nyour commits to. Make sure you're in `webwml` directory, and run:\n\n    git remote add pick-a-name your-git-url\n\n_Example:_\n    `git remote add tpo-gh git@github.com:mrphs/tpo.git`\n\n__Step 2:__ Create and switch to a new branch.\n\n_In the following example, I've named my branch \"docs\" as I'm planning to work\non the documentations._\n\n    git checkout -b docs\n\n__Step 3:__ Now you can start working on website and make changes. Once you're\ndone, commit and push it to your public repo.\n\n_Example:_\n\n    git push tpo-gh docs\n\n__Step 4:__ Open a new ticket on [trac](https://trac.torproject.org) with a\nlink to your shiny new repo/branch.\n\n# Building website\nTorproject website is being built and published automatically.\nTo quickly get set up and build website locally, simply follow these steps:\n\n __Step 1:__ Get the website's build dependencies.\n\n    sudo apt-get install wml asciidoc\n\n  __Step 2:__ Configure where to find your tor git repository. It needs this\nto make the\n     manual page.\n\n    git clone https://git.torproject.org/project/web/webwml.git\n    cd webwml\n    cp Makefile.local.sample Makefile.local\n\nNote: Change the `TORGIT` in Makefile.local to point to your tor git repo.\n\n  __Step 3:__ Make the website.\n\n    make\n\nYou should now be able to point your browser at the locally generated site...\n\n    file:///home/atagar/Desktop/tor/webwml/getinvolved/volunteer.html.en\n\n\n### Troubleshooting the build\n\nThe build fails with \"Invalid object name\".\n\n  If you get an error like...\n\n    ---- Contents of STDERR channel: ---------\n    fatal: Invalid object name 'tor-0.2.6.1-alpha'.\n    asciidoc: FAILED: manpage document title is mandatory\n    No manpage because of asciidoc error or file not available from git at\n    /tmp/wml.zwcq0q/wml.30867.tmp1.wml line 415.\n\n  This means your tor repository is out of date. Update your tor git\nrepository.\n\n### Some information regarding working with minified CSS and JS sources\n\nIf you want to edit any of the CSS or JS sources, please bear in mind that the HTML uses the minified versions. We keep in the repository both versions side-to-side. Once you edit the original source make sure you generate the minified version again. Most editors have plugins to minify CSS and JS files. On Debian it is possible to install the yui-compressor package and use it as follows:\n\n\n    yui-compressor myfile.js -o myfile-min.js\n\n\nIf you are wondering why is it \"cool\" to minify sources even though compression is used on the server, please consider that Minification can be well be used in combination with gzipping sources. Minification does a lot of additional things that compression doesn't do. During minification comments are removed, long variables are renamed to shorter variable names, etc. Transferred data can be significantly smaller after minification, than by simply compressing the original. Although this depends a lot on the original source, minifying helps with mobile browsers and slower connections.\n\n### More detailed instructions from Roger\n\n_Note: This section was written when website repo was still on svn, and it\nwasn't built automatically._\n\nHere are the instructions I sent David Fifield when he asked about\nediting the website. I hope they are useful for you too! --Roger\n\nCopy Makefile.local.sample to Makefile.local in your webwml/ directory.\nPoint TORGIT to a tor git.\n\nThen apt-get install wml and (alas) probably a shocking number of other\ndebs. Then you can type 'make' and it will build the website for you\nlocally. It's probably a smart move to see whether 'make' works before\nyou git commit any changes to the wml files.\n\nYou can edit docs/en/pluggable-transports.wml (and that is\nthe right source file to edit, not the html). But go take a\nlook at that file. You'll notice it has a bunch of tags like\n\u003cversion-torbrowserbundle\u003e. If you're just bumping version\nnumbers, you probably just want to change the definition of those tags.\nThey're in include/versions.wmi\n\n(Every once in a while you may need to edit pluggable-transports.wml\ntoo -- generally when you change the file name so drastically that just\nchanging the versions.wmi tags isn't enough.)\n\nPushes to the master branch of the git repository will cause the\nwebsite to get re-built and published. Pushing to the staging branch\nwill update www-staging.torproject.org.\n\nAlas, https://www.torproject.org/dist/ isn't in version control. You\nwrite to it by ssh'ing to dist-master.torproject.org and going to\n/srv/dist-master.torproject.org/htdocs/ and then sticking your stuff\nthere. When you want it to go live, you run\n\"static-update-component dist.torproject.org\" on dist-master.\n\nWeasel has hopes that somebody will write some scripts to make maintaining\npackages in dist/ less awful -- automatically check that they have\nsignatures and that the sigs match, that the items on the website are in\nfact in dist, only allow certain people to put files in certain places,\netc. One day! :)\n# tp_donation\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamdney%2Fwebwml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamdney%2Fwebwml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamdney%2Fwebwml/lists"}