{"id":21485308,"url":"https://github.com/igneus/ordodo","last_synced_at":"2025-03-17T09:45:32.155Z","repository":{"id":23806871,"uuid":"99897204","full_name":"igneus/ordodo","owner":"igneus","description":"generator of *ordo* (combined liturgical calendar for print)","archived":false,"fork":false,"pushed_at":"2023-04-12T00:06:34.000Z","size":135,"stargazers_count":2,"open_issues_count":4,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-05-23T04:29:56.643Z","etag":null,"topics":["calendar","church","liturgy","ruby"],"latest_commit_sha":null,"homepage":null,"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/igneus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2017-08-10T07:58:17.000Z","updated_at":"2020-07-11T20:48:44.000Z","dependencies_parsed_at":"2024-11-23T13:24:56.995Z","dependency_job_id":null,"html_url":"https://github.com/igneus/ordodo","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/igneus%2Fordodo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igneus%2Fordodo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igneus%2Fordodo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igneus%2Fordodo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/igneus","download_url":"https://codeload.github.com/igneus/ordodo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244013291,"owners_count":20383707,"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":["calendar","church","liturgy","ruby"],"created_at":"2024-11-23T13:14:51.476Z","updated_at":"2025-03-17T09:45:32.135Z","avatar_url":"https://github.com/igneus.png","language":"Ruby","funding_links":[],"categories":["Applications"],"sub_categories":[],"readme":"# OrdoDO - *Ordo Divini Officii*\n\nGenerates an *ordo* (also known as [directory][wikipedia])\nfor a hierarchically organized set\nof Roman Catholic liturgical calendars.\n\n![OrdoDO logo](/img/or_dodo_logo.png)\n\n## The problem\n\nEvery year, hundreds of Catholics around the world spend possibly\nhundreds of hours each, compiling an *ordo*, a liturgical calendar\nof their country, diocese or religious institute,\nfor the new liturgical year. Usually by hand.\n\n*Ordo* is basically a combination of a set of closely related\nliturgical calendars, e.g. calendars of dioceses of one country\nor of houses of one province of some religious institute.\n\nThe task of compiling an *ordo* is extremely repetitive\nand can be - completely or at least to a great extent -\nautomated. Let `ordodo` do the heavy lifting for you!\n\n## Features\n\n**Example output:**\n\n* Ordo for dioceses of Czech Republic:\n  - [2016/17](http://yakub.cz/ordo_2016/)\n  - [2017/18](http://yakub.cz/ordo_2017/)\n  - [2018/19](http://yakub.cz/ordo_2018/)\n  - [2019/20](http://yakub.cz/ordo_2019/)\n\nThe current sample is a simple HTML page. Support for multiple\noutput formats will be added later, with special focus\non print-ready pdf output.\n\n- [x] liturgical calendar computing\n- [x] variants from proper calendars (with support for unlimited calendar levels)\n- [ ] Gloria and Credo\n- [ ] prefaces and the eucharistic prayer IV\n- [ ] occasional parts of the Roman Canon\n- [x] Divine Office hints (Vespers, Compline, Daytime Prayer)\n- [ ] votive masses\n- [ ] burial masses\n- [ ] occasional blessings and other rites\n- [ ] support for other date-related directions (often \"International day of ..., should be mentioned in the universal prayer\")\n\n## Installation\n\nis not really possible yet. But you can play with `ordodo`\nnevertheless: install Ruby and Bundler, then clone `ordodo`\nsources,\n\n`bundle install`\n\nin the project's root directory to install dependencies\nand then execute `ordodo` like\n\n`bundle exec ruby -Ilib bin/ordodo ...`\n\n## Basic usage\n\n`$ ordodo myconfig.xml`\n\ngenerates ordo according to configuration in `myconfig.xml`\nfor the upcoming liturgical year. Definitely the most common\ntask you will use `ordodo` for.\n\nOutput is by default produced in directory `ordo_YEAR`,\ncreated in the current working directory.\n\n`$ ordodo myconfig.xml 2050`\n\ngenerates ordo for the year specified (which, of course, knows\nnothing about calendar updates which will probably happen\nin the meantime).\n\nIn the `examples/` directory you can find a few example\nconfigurations to start with.\n\n## Configuration\n\n`ordodo`'s main user interface is it's configuration file.\n\n**Philosophy behind it:**\n*ordo* is prepared only once a year, and it's content is \"mostly\nthe same\". As a user you don't want to remember anything about\n`ordodo` - this program used once a year - and it's controls and\nsettings. You want to set it up once\n(or have someone set it up for you) - and then it should, if possible,\njust work forever. Once a year you run `ordodo`\nwith the configuration from the last year, check that the output\nis correct, send it to print. All done.\n\nSee `examples/czech_republic.xml` for a complete and commented\nconfiguration of an *ordo* for Czech dioceses.\nIt uses most features currently available, and mentions\nthose which are not used.\n\n### Preparing calendar data\n\nFor calendar computations `ordodo` relies on\n[calendarium-romanum][caro]. It also expects calendar data\nin it's [data format][caro_data].\n\n### Customization of translation strings and output templates\n\n## License\n\nMIT\n\n## Credits\n\n`ordodo` logo incorporates\na [drawing of a dodo][dodo_img_source]\nby Pearson Scott Foresman. The drawing is in public domain.\n\n[dodo_img_source]: https://commons.wikimedia.org/wiki/Raphus_cucullatus#/media/File:Dodo_2_(PSF).png\n[wikipedia]: https://en.wikipedia.org/wiki/Directorium\n[caro]: http://github.com/igneus/calendarium-romanum\n[caro_data]: https://github.com/igneus/calendarium-romanum/tree/master/data\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figneus%2Fordodo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Figneus%2Fordodo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figneus%2Fordodo/lists"}