{"id":16729560,"url":"https://github.com/darwindarak/mdx_bib","last_synced_at":"2025-03-21T21:31:13.065Z","repository":{"id":34948206,"uuid":"39023024","full_name":"darwindarak/mdx_bib","owner":"darwindarak","description":"A Python-Markdown extension for RMarkdown-style bibliographies and citations","archived":false,"fork":false,"pushed_at":"2024-06-23T04:15:55.000Z","size":10,"stargazers_count":15,"open_issues_count":2,"forks_count":12,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-18T05:22:52.112Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/darwindarak.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":"2015-07-13T16:11:45.000Z","updated_at":"2024-11-08T03:49:58.000Z","dependencies_parsed_at":"2024-06-23T06:28:26.913Z","dependency_job_id":null,"html_url":"https://github.com/darwindarak/mdx_bib","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/darwindarak%2Fmdx_bib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darwindarak%2Fmdx_bib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darwindarak%2Fmdx_bib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darwindarak%2Fmdx_bib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/darwindarak","download_url":"https://codeload.github.com/darwindarak/mdx_bib/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244874158,"owners_count":20524576,"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-10-12T23:29:03.308Z","updated_at":"2025-03-21T21:31:12.567Z","avatar_url":"https://github.com/darwindarak.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bibliography and Citation support for Python-Markdown\n\nThis extension to Python Markdown is inspired by the support for citations in [R Markdown][].\nIt looks for all citation keys with the form `@\u003ccitekey\u003e` inside matching square brackets and appends a bibliography to the output.\nThe references associated with the citation keys can be defined manually or generated from a BibTeX file.\n\n## Installation\n\nRunning \n\n```bash\n$ python setup.py build\n$ python setup.py install\n```\n\nwill install a module named `mdx_bib`.\n\n```python\nimport markdown\nfrom mdx_bib import CitationsExtension\n\ncite = CitationsExtension(bibtex_file='library.bib', order='unsorted')\nhtml = markdown.markdown(text, extensions=[cite])\n```\n\n## Syntax\n\nCitation keys are any identifiers inside square brackets with a `@`-prefix\n\n```markdown\nSome claim [see @adams98].\n\nSome claim [@adams98; @barney04].\n```\n\nThe first line will be converted\n\n```html\n\u003cp\u003eSome claim [see \u003ca id=\"cite-adams98\" href=\"#ref-adams98\" class=\"citation\u003e@adams98\u003c/a\u003e.\u003c/p\u003e\n```\n\nThis extension will first look for any manually defined bibligraphy entries, for example\n\n```markdown\n[@barney04]: Barneby, C.D. *A review of reviews*. Annual Reviews of Something (2104)\n```\n\nIf a matching reference definition cannot be found, then the extension looks in the BibTeX file for a matching citation key.\n\n[R Markdown]: http://rmarkdown.rstudio.com/authoring_bibliographies_and_citations.html\n\n## Changelog\n\n### 2023-04-05\n\n- replace from `markdown.util import etree` with `import xml.etree.ElementTree as etree` per this [Python-Markdown 3.2 changelog](https://github.com/Python-Markdown/markdown/blob/master/docs/change_log/release-3.2.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarwindarak%2Fmdx_bib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarwindarak%2Fmdx_bib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarwindarak%2Fmdx_bib/lists"}