{"id":18756446,"url":"https://github.com/libgit2/docurium","last_synced_at":"2025-04-05T09:06:45.184Z","repository":{"id":661138,"uuid":"1862638","full_name":"libgit2/docurium","owner":"libgit2","description":"Doxygen replacement for the libgit2 project","archived":false,"fork":false,"pushed_at":"2022-02-09T14:16:22.000Z","size":948,"stargazers_count":159,"open_issues_count":11,"forks_count":21,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-03-29T08:06:27.047Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://libgit2.github.com/libgit2","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/libgit2.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}},"created_at":"2011-06-07T23:04:00.000Z","updated_at":"2024-11-13T12:11:06.000Z","dependencies_parsed_at":"2022-08-06T10:00:24.852Z","dependency_job_id":null,"html_url":"https://github.com/libgit2/docurium","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libgit2%2Fdocurium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libgit2%2Fdocurium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libgit2%2Fdocurium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libgit2%2Fdocurium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/libgit2","download_url":"https://codeload.github.com/libgit2/docurium/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247312077,"owners_count":20918344,"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":"2024-11-07T17:36:40.484Z","updated_at":"2025-04-05T09:06:45.090Z","avatar_url":"https://github.com/libgit2.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docurium\n\nDocurium is a lightweight Doxygen replacement.  It generates static HTML from the header files of a C project. It is meant to be simple, easy to navigate and git-tag aware. It is only meant to document your public interface, so it only knows about your header files.\n\nI built it to replace the Doxygen generated documentation for the libgit2 project, so I'm only currently testing it against that.  So, it is only known to include support for features and keywords used in that project currently.  If you have a C library project you try this on and something is amiss, please file an issue or better yet, a pull request.\n\nThough Docurium can generate your docs into a subdirectory, it is meant to be served from a webserver, not locally.  It uses XMLHttpRequest calls, which cannot be done locally, so you can't just open the index.html file locally and have it work - you need to either run a webserver in the output directory or push it to a website to view it properly.  I use Pow (pow.cx) or GitHub Pages.\n\n# Usage\n\nRun the `cm` binary and pass it your Docurium config file.\n\n    $ cm doc api.docurium\n    * generating docs\n      - processing version v0.1.0\n      - processing version v0.2.0\n      - processing version v0.3.0\n      - processing version v0.8.0\n      - processing version v0.10.0\n      - processing version v0.11.0\n      - processing version v0.12.0\n      - processing version HEAD\n    * checking your api\n      - unmatched params in\n          git_commit_create\n          git_config_set_int\n          git_object_lookup_prefix\n      - signature changes in\n          git_index_get\n          git_repository_path\n          git_tree_entry_byindex\n    * writing to branch gh-pages\n        wrote tree   87f0f3cb1622b9dc3d6d5d39106e863608b3b504\n        wrote commit 5cee46f4d491e9611abab218604db893b70202f3\n        updated gh-pages\n\nDocurium will tell you if you have unmatched @params entries in header docs and if you've changed signatures in functions in HEAD, just to help you know what's happening and if you've written your docs properly.\n\nThe Docurium config file looks like this:\n\n    {\n     \"name\":   \"libgit2\",\n     \"github\": \"libgit2/libgit2\",\n     \"input\":  \"include/git2\",\n     \"prefix\": \"git_\",\n     \"branch\": \"gh-pages\",\n     \"examples\": \"examples\",\n     \"legacy\":  {\n        \"input\": {\"src/git\": [\"v0.1.0\"],\n                  \"src/git2\": [\"v0.2.0\", \"v0.3.0\"]}\n      }\n    }\n\nDocurium will write your docs directly into the specified Git branch.\n\n# Installing\n\n    $ gem install docurium\n\n# Contributing\n\nIf you want to fix or change something, please fork on GitHub, push your change to a branch named after your change and send me a pull request.\n\n# License\n\nMIT, see LICENCE file\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibgit2%2Fdocurium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibgit2%2Fdocurium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibgit2%2Fdocurium/lists"}