{"id":18033481,"url":"https://github.com/tohojo/bufferbloat-net","last_synced_at":"2025-04-04T22:25:33.808Z","repository":{"id":9114106,"uuid":"60783636","full_name":"tohojo/bufferbloat-net","owner":"tohojo","description":"The source repository for the bufferbloat.net web site","archived":false,"fork":false,"pushed_at":"2025-02-19T06:51:11.000Z","size":21013,"stargazers_count":55,"open_issues_count":16,"forks_count":34,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-02-19T07:31:36.596Z","etag":null,"topics":["bufferbloat"],"latest_commit_sha":null,"homepage":"https://www.bufferbloat.net","language":"PostScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tohojo.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}},"created_at":"2016-06-09T15:04:19.000Z","updated_at":"2025-02-19T06:51:15.000Z","dependencies_parsed_at":"2023-01-11T20:11:44.965Z","dependency_job_id":"4995aa6a-55da-49d2-a590-dfd5fa38b1a3","html_url":"https://github.com/tohojo/bufferbloat-net","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tohojo%2Fbufferbloat-net","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tohojo%2Fbufferbloat-net/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tohojo%2Fbufferbloat-net/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tohojo%2Fbufferbloat-net/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tohojo","download_url":"https://codeload.github.com/tohojo/bufferbloat-net/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247257375,"owners_count":20909467,"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":["bufferbloat"],"created_at":"2024-10-30T11:07:28.506Z","updated_at":"2025-04-04T22:25:33.791Z","avatar_url":"https://github.com/tohojo.png","language":"PostScript","readme":"# Bufferbloat.net web site source\n\nThis repo contains the source files for the bufferbloat.net web site\n(https://www.bufferbloat.net). The site is built using the Hugo static\nsite generator (https://gohugo.io) and most of the content is\nautomatically converted from the old bufferbloat.net redmine\ninstallation.\n\nContributions to improve the content are very welcome. See below for\nsome pointers on how the content is organised and how to contribute.\n\n## Organisation of this repository\n\nThe content shown on the site is all in the `content` directory. Each\nsubdirectory is a project, which in turn has subdirectories\ncorresponding to the different types of content. Currently, these are\n`wiki` for Wiki pages, `news` for news items and `issues` for the\nexported bug reports from the old site. The latter is mainly kept for\narchival purposes, and is probably not worth editing.\n\nThe scripts used to convert the content from the old site live in the\n`export` directory, which also contains the csv files with the data.\nHopefully, there shouldn't be a need to run these anymore. The\n`old-projects` directory contains exported data for projects that it was\nnot deemed relevant to move over to the new site. This data is here for\narchival purposes and is not used when generating the site.\n\nFinally, the `static` directory contains resources such as images and\nCSS files used for the site layout, and the `layouts` directory contains\nthe templates Hugo uses to build the site.\nFor more information on how the latter works,\nconsult the documentation at [https://gohugo.io.](https://gohugo.io)\n\n## Contributing to the Site\n\nTo contribute to the site, simply clone the repository, make your\nchanges to the markdown file corresponding to the page you wish to edit,\ncommit the results and open a pull request against this repository.\nIt is also possible to file issues to point out errors or omissions, or\ngive suggestions for the content.\n\nThe site is build using the [Hugo static site generator.](https://gohugo.io/)\nVersion 0.16 (not higher!) is required to build the site.\nSee the **Using Docker for development** section below.\n\n### Live Editing\n\nWhen making changes, you can see a local version of the site by\ninstalling Hugo and running `hugo serve` in this directory. That will\nrun a web server on localhost, which you can navigate to and see a live\nversion of the site.\n\n### Creating a new News Item\n\nYou can use the hugo binary to create a new news item with appropriate\nfront matter (the stuff in the top that tells Hugo that this is a news\nitem). First, decide which project the news item should belong to, then\nissue a command like\n\n  `hugo new -k news bloat/news/2016-06-12-my-news-heading.md`\n\nto create the new file (the `-k news` tells Hugo to create a news item).\n\nThe new item will be marked as a draft and appear in the\n`content/bloat/news` directory. You can then edit the file (don't forget\nto the title and add your name as author). While you are editing, you\ncan run `hugo -D serve` to see the changes in real-time (the `-D` means\n'show drafts'). When you are done you can either manually change the\ndraft status at the top of the file, or you can use the `hugo undraft`\ncommand to do it for you. Then add the file to git and submit a pull\nrequest to have your news item included on the site.\n\n## Using Docker for development\n\nThe Bufferbloat.net site relies on Hugo 0.16 capabilities.\n(Newer Hugo versions give _WARNING: blackfriday's\nsourceRelativeLinksEval is deprecated ..._ error messages\nfor the hundreds of internal links in the repo.)\n\nDocker provides an easy way to run Hugo 0.16 reliably on any OS.\nThe [codycraven/docker-hugo](https://github.com/codycraven/docker-hugo)\nrepo has a container for creating and running a Hugo server in Docker.\n\nThe Docker instance operates on the current directory,\nso normal editing, `git` commands, etc. work as desired.\n\n### Run the Hugo server in Docker\n\nThis command runs the Hugo server, listening on port 8080.\nTo use it, `cd \u003cdirectory-containing-your-Hugo-files\u003e` \nthen issue the `docker run...` command each time you edit the site.\n\n```\ncd \u003cdirectory-containing-your-Hugo-files\u003e\n\ndocker run --rm -it \\\n    -v /tmp:/tmp \\\n    -v $(pwd):/site \\\n    -w /site \\\n    -p 8080:8080 \\\n    codycraven/hugo:0.16 \\\n    server \\\n    --bind=0.0.0.0 \\\n    --port=8080 \\\n    -w\n```\n\nFollow the link to [localhost:8080/projects](localhost:8080/projects),\nand you'll see the blog as it appears.\nAs you edit the underlying pages, the web display will update live.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftohojo%2Fbufferbloat-net","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftohojo%2Fbufferbloat-net","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftohojo%2Fbufferbloat-net/lists"}