{"id":13878362,"url":"https://github.com/skatkov/rdoc-markdown","last_synced_at":"2025-10-15T13:15:54.542Z","repository":{"id":60364268,"uuid":"542641967","full_name":"skatkov/rdoc-markdown","owner":"skatkov","description":"RDoc to Markdown generator","archived":false,"fork":false,"pushed_at":"2024-12-28T23:17:47.000Z","size":117,"stargazers_count":24,"open_issues_count":7,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-13T21:49:34.594Z","etag":null,"topics":["generator","markdown","rdoc","ruby"],"latest_commit_sha":null,"homepage":"https://poshtui.com","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/skatkov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2022-09-28T14:47:49.000Z","updated_at":"2024-12-28T23:17:50.000Z","dependencies_parsed_at":"2023-01-22T13:00:11.822Z","dependency_job_id":"7efdc00a-0576-41f5-8a05-a7535092ecf7","html_url":"https://github.com/skatkov/rdoc-markdown","commit_stats":{"total_commits":77,"total_committers":2,"mean_commits":38.5,"dds":0.1298701298701299,"last_synced_commit":"22964f3458945bd72ea575a64e0d318ed0641558"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/skatkov/rdoc-markdown","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skatkov%2Frdoc-markdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skatkov%2Frdoc-markdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skatkov%2Frdoc-markdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skatkov%2Frdoc-markdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skatkov","download_url":"https://codeload.github.com/skatkov/rdoc-markdown/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skatkov%2Frdoc-markdown/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279081994,"owners_count":26099318,"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-15T02:00:07.814Z","response_time":56,"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":["generator","markdown","rdoc","ruby"],"created_at":"2024-08-06T08:01:47.376Z","updated_at":"2025-10-15T13:15:54.356Z","avatar_url":"https://github.com/skatkov.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"# RDoc-Markdown\nRDoc plugin to generate markdown documentation and search index backed by sqlite database.\n\n## Motivation\nMarkdown has become the de-facto documentation standard. I heavily rely on Obsidian to render my storage of markdown notes. But markdown is used not just for scribbles, supported is far and wide. We can render markdown file on any device, probably even on thermometer with a screen. But also everyone knows enough markdown to be dangerous (or productive).\n\nIt's a pitty that rdoc and yard can't output a proper markdown file. I would like to change that.\n\n## Installation\n\nInstall gem and add to application's Gemfile by executing:\n\n    $ bundle add rdoc-markdown\n\nIf bundler is not being used to manage dependencies, install the gem by executing:\n\n    $ gem install rdoc-markdown\n## Examples\nFind examples in [/examples](/example/) folder. You can regenerate examples by running `./bin/generate.sh`, it will produce examples based on file in `test/data/*` folder.\n\n\n## Usage\nRDoc will auto-detect rdoc-markdown plugin if it was installed. You just need to instruct RDoc to produce markdown output instead of standard HTML through `format` parameter.\n\nRun following command in directory with ruby source code:\n\n`rdoc --format=markdown`\n\nThis will produce a tree of markdown documents and search index in `/doc` folder. Every class in library will have it's own markdown file.\n\n## Note on index.csv file\nThis gem emits index of all markdown files in a index.csv file.\n\nThere are decent tools that offer search through structured plain-text files. But my expectation is that nobody will use CSV as an actual search index, but rather import it into something that performs this function better.\n\nIn my personal use-case, I use SQLite. All other databases seem to have a good support for CSV imports.\n\n## Development\nBiggest issue is testing this locally, but that's not as hard to do these days.\n\n```\ngem build rdoc-markdown.gemspec\n```\n\n```\ngem install \u003cpath-to\u003e/rdoc-markdown-0.1.2.gem\n```\n\nor you can do the same, but through gemfile:\n\n```\ngem 'rdoc-markdown`, path: \"../rdoc-markdown/`\n```\n\n## Testing\nFollowing command should run entire testsuit:\n```\nrake test\n```\nTesting is not excessive, just verifies that basic functionality is operational.\n## Release\n```\ngem build rdoc-markdown.gemspec\ngem push rdoc-markdown-0.1.2.gem\n```\n\nThere is `./bin/publish.sh` script that does that. But it assumes, that you have [gum library](https://github.com/charmbracelet/gum) installed.\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/skatkov/rdoc-markdown. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/skatkov/rdoc-markdown/blob/master/CODE_OF_CONDUCT.md).\n\n## Code of Conduct\n\nEveryone interacting in the Rdoc::Markdown project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/skatkov/rdoc-markdown/blob/master/CODE_OF_CONDUCT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskatkov%2Frdoc-markdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskatkov%2Frdoc-markdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskatkov%2Frdoc-markdown/lists"}