{"id":15893436,"url":"https://github.com/multimeric/sphinxcontrib-restbuilder","last_synced_at":"2025-04-02T17:42:56.105Z","repository":{"id":85377392,"uuid":"76434742","full_name":"multimeric/sphinxcontrib-restbuilder","owner":"multimeric","description":"Clone of https://bitbucket.org/birkenfeld/sphinx-contrib/src/7e91c349bea0/restbuilder/?at=default with fixes","archived":false,"fork":false,"pushed_at":"2016-12-19T06:50:54.000Z","size":41,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-21T05:23:37.750Z","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/multimeric.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","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":"2016-12-14T07:17:21.000Z","updated_at":"2016-12-19T05:26:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"e6eb03a6-0e5d-4537-b032-85d41a5051dd","html_url":"https://github.com/multimeric/sphinxcontrib-restbuilder","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/multimeric%2Fsphinxcontrib-restbuilder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multimeric%2Fsphinxcontrib-restbuilder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multimeric%2Fsphinxcontrib-restbuilder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multimeric%2Fsphinxcontrib-restbuilder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/multimeric","download_url":"https://codeload.github.com/multimeric/sphinxcontrib-restbuilder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246863828,"owners_count":20846319,"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-06T08:10:33.809Z","updated_at":"2025-04-02T17:42:56.074Z","avatar_url":"https://github.com/multimeric.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. -*- restructuredtext -*-\n\n=======================\nREADME for reST Builder\n=======================\n\nSphinx_ extension to build reST (reStructuredText_) files.\n\nThis extension is in particular useful to use in combination with the autodoc\nextension to automatically generate documentation for use by any rst parser\n(such as the GitHub wiki).\n\nIn itself, the extension is fairly straightforward -- it takes the parsed reST \nfile from Sphinx_ and outputs it as reST.\n\nRequirements\n============\n\n* Sphinx_ 1.0 or later\n* Python 2.6 or later\n\nInstalling\n==========\n\nUsing pip\n---------\n\n    pip install sphinxcontrib-restbuilder\n\nManual\n------\n\n    hg clone http://bitbucket.org/birkenfeld/sphinx-contrib\n    cd sphinx-contrib/restbuilder\n    python setup.py install\n\nIf you want to take a look and have a try, you can put the reST builder in\nan extension subdirectory, and adjust ``sys.path`` to tell Sphinx where to\nlook for it:\n\n- Add the extensions directory to the path in ``conf.py``. E.g.\n\n    sys.path.append(os.path.abspath('exts'))\n\nUsage\n=====\n\n- Set the builder as a extension in ``conf.py``:\n\n    extensions = ['sphinxcontrib.restbuilder']\n\n- Run sphinx-build with target ``rst``:\n\n    sphinx-build -b rst -c . build/rst\n\nConfiguration\n=============\n\nThe following four configuration variables are defined by sphinxcontrib.restbuilder:\n\n.. confval:: rst_file_suffix\n\n   This is the file name suffix for generated reST files.  The default is\n   ``\".rst\"``.\n\n.. confval:: rst_link_suffix\n\n   Suffix for generated links to reST files.  The default is whatever\n   :confval:`rst_file_suffix` is set to.\n\n.. confval:: rst_file_transform\n\n   Function to translate a docname to a filename. \n   By default, returns `docname` + :confval:`rst_file_suffix`.\n\n.. confval:: rst_link_transform\n\n   Function to translate a docname to a (partial) URI. \n   By default, returns `docname` + :confval:`rst_link_suffix`.\n\n\nFurther Reading\n===============\n\n.. _Sphinx: http://sphinx-doc.org/\n.. _`sphinx-contrib`: http://bitbucket.org/birkenfeld/sphinx-contrib\n.. _reStructuredText: http://docutils.sourceforge.net/rst.html\n\nFeedback\n========\n\nThe reST builder is in a preliminary state. It's not (yet) widely used, so\nany feedback is particularly welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmultimeric%2Fsphinxcontrib-restbuilder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmultimeric%2Fsphinxcontrib-restbuilder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmultimeric%2Fsphinxcontrib-restbuilder/lists"}