{"id":19693015,"url":"https://github.com/bndtools/bndtools.github.io","last_synced_at":"2025-08-26T08:14:56.319Z","repository":{"id":1955224,"uuid":"2885455","full_name":"bndtools/bndtools.github.io","owner":"bndtools","description":"Bndtools.org Main Site","archived":false,"fork":false,"pushed_at":"2025-08-18T19:35:43.000Z","size":52104,"stargazers_count":5,"open_issues_count":7,"forks_count":20,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-08-18T21:28:22.207Z","etag":null,"topics":["bndtools"],"latest_commit_sha":null,"homepage":"https://bndtools.org","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bndtools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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}},"created_at":"2011-11-30T18:53:06.000Z","updated_at":"2025-08-18T19:35:42.000Z","dependencies_parsed_at":"2023-02-19T08:00:31.683Z","dependency_job_id":"f57dc41a-5912-4e09-a9c3-af9e9470cfe1","html_url":"https://github.com/bndtools/bndtools.github.io","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bndtools/bndtools.github.io","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bndtools%2Fbndtools.github.io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bndtools%2Fbndtools.github.io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bndtools%2Fbndtools.github.io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bndtools%2Fbndtools.github.io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bndtools","download_url":"https://codeload.github.com/bndtools/bndtools.github.io/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bndtools%2Fbndtools.github.io/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272192681,"owners_count":24889461,"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-08-26T02:00:07.904Z","response_time":60,"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":["bndtools"],"created_at":"2024-11-11T19:15:14.650Z","updated_at":"2025-08-26T08:14:56.287Z","avatar_url":"https://github.com/bndtools.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bndtools.org Main Website\n=====================\n\nThis repository holds the bndtools.org website hosted at [https://bndtools.org][bndtools].\nThis web site is maintained as markdown and turned into HTML by [Jekyll][jekyll]\nusing [GitHub Pages](https://help.github.com/articles/what-are-github-pages/).\n\n## Local development\n\n- install ruby 2.7\n- call `./run.sh` on the commandline\n\nThis should install jekyll and start a local webserver at:\n\n- http://127.0.0.1:4000/\n\nStart editing markdown `.md` files. Jekyll will auto-detect changes and reload the website. Some changes require a restart (e.g. changes to `_config.yml`)\n\n## Local development with Pagefind search\n\nWe use https://pagefind.app/ for our search field full text search. \nBut it is currently not automatically working when using `./run.sh` above, because it works on the \nactual build-output on the `_site` folder (which contains the actual `.html` pages). \n\nTo test the search locally based on the `_site` folder content, run:\n\n\n`./run-pagefind-linux.sh`\n\nor\n\n`run-pagefind-macos.sh`\n\ndepending on which operating system you are using. \n\nThe result should look like:\n\n`Serving \"_site\" at http://localhost:1414`\n\n\nThe script will download and execute the pagefind executable binary after the build.\nThen it will start a small server where you test the result. \nNote, that this is different than the `./run.sh` and does not support real-time editing of the content.\n\nFeel free to adjust / extend the start-scripts if you have a different architecture \nor to use a different `pagefind` version. \n\n### pagefind for production build via github actions\n\nSee the files `.github/workflows/cibuild.yml` and `.github/scripts/docs.sh` for how \nbuilding the site and executing `pagefind` is done in the final build on github.\n\n### CSS Styling for Code Highlighter\n\n- jekyll uses `rouge` code highlighter\n- see `_config.yml` and section `syntax_highlighter_opts`\n- also see this website https://jekyll-themes.com/brazacz/rouge-themes for examples\n- rouge is compatible with and can use 'pygments' styles (see https://pygments.org/styles/)\n- these styles can be generated with the command \n\nThe following commands locally will help to generate the .css files for the pygment styles:\n\n```\ngem install rouge\n\n# show a list of supported styles\nrougify help style\n\n# go to the css folder\ncd css\n\n# generate the css\nrougify style monokai \u003e monokai.css\n```\n\nThen reference the `.css` file in `_includes/head.html `\n\n\n\n## Feedback\n\nFeedback is always welcome.\nFor general discussions use the \u003cbndtools-users@googlegroups.com\u003e list.\nWe also have the \u003cbndtools-dev@googlegroups.com\u003e list for discussions on the development of bndtools.\n\nBugs and issues for the [https://bndtools.org][bndtools] website should go to \u003chttps://github.com/bndtools/bndtools.github.io/issues\u003e\n\n## Contributing\n\nWant to hack on the bndtools.org website? See [CONTRIBUTING.md](CONTRIBUTING.md) for information on building, testing and contributing changes.\n\nThey are probably not perfect, please let us know if anything feels\nwrong or incomplete.\n\n## License\n\nThe contents of this repository are made available to the public under the terms of the [Eclipse Public License v1.0](http://www.eclipse.org/legal/epl-v10.html).\n\n[bndtools]: https://bndtools.org\n[jekyll]: http://jekyllrb.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbndtools%2Fbndtools.github.io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbndtools%2Fbndtools.github.io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbndtools%2Fbndtools.github.io/lists"}