README - General description of the doxphinx project
Copyright (C) 2018-2023 Angel Linares Zapater
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License, version 2, as
published by the Free Software Foundation. See the COPYING file.
This program is distributed WITHOUT ANY WARRANTY; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Getting started
===============
doxphinx is a theme for the Sphinx documentation system. The purpose of doxphinx
is to provide a single mechanism to generate the documentation of a project,
both in HTML and PDF formats, from a common source.
This common source of documentation consists of a set of text files written in
reStructuredText markup language along with a set of conventions for writing and
organizing the different files. The Sphinx tool can then be used to
automatically generate a HTML website or a PDF book, both from the same single
documentation source.
How to use
==========
In order to use doxphinx to document any project, just install it using:
$ pip install doxphinx
Then create a directory for the documentation files and using the Sphinx tool:
$ sphinx-quickstart
Initialize the directory as a Sphinx project and configure the conf.py file that
has been created, and you are ready to build the documentation using doxphinx.
See "The doxphinx Handbook" <https://docs.phyglos.org/doxphinx> to learn how to use
doxphinx in your documentation project.
At this point you can focus on the actual documentation work for your project.
Whenever the documentation is ready to be published or updated, use Sphinx to format
again the HTML website or the PDF book from the documentation source files.
Status
======
The doxphinx project is in STABLE status.
More information
================
The COPYING file contains the GNU License for this software.
The RELEASE file describes the main changes in this release.
See https://docs.phyglos.org/doxphinx for more information.
Raw data
{
"_id": null,
"home_page": "http://doxphinx.org/",
"name": "doxphinx",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "doxphinx,sphinx,phyglos",
"author": "Angel Linares Zapater",
"author_email": "alz@phyglos.org",
"download_url": "https://files.pythonhosted.org/packages/a7/7a/954448306f8a6d482871c4f811aad1a4720da287a661d3f9c4e45d61c38b/doxphinx-1.7.0.tar.gz",
"platform": null,
"description": " README - General description of the doxphinx project\n\n Copyright (C) 2018-2023 Angel Linares Zapater\n\n This program is free software; you can redistribute it and/or modify\n it under the terms of the GNU General Public License, version 2, as\n published by the Free Software Foundation. See the COPYING file.\n\n This program is distributed WITHOUT ANY WARRANTY; without even the\n implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n\nGetting started\n===============\n\ndoxphinx is a theme for the Sphinx documentation system. The purpose of doxphinx\nis to provide a single mechanism to generate the documentation of a project,\nboth in HTML and PDF formats, from a common source.\n\nThis common source of documentation consists of a set of text files written in\nreStructuredText markup language along with a set of conventions for writing and\norganizing the different files. The Sphinx tool can then be used to\nautomatically generate a HTML website or a PDF book, both from the same single\ndocumentation source.\n\nHow to use\n==========\n\nIn order to use doxphinx to document any project, just install it using:\n\n $ pip install doxphinx\n\nThen create a directory for the documentation files and using the Sphinx tool:\n\n $ sphinx-quickstart\n\nInitialize the directory as a Sphinx project and configure the conf.py file that\nhas been created, and you are ready to build the documentation using doxphinx.\n\nSee \"The doxphinx Handbook\" <https://docs.phyglos.org/doxphinx> to learn how to use\ndoxphinx in your documentation project.\n\nAt this point you can focus on the actual documentation work for your project.\nWhenever the documentation is ready to be published or updated, use Sphinx to format\nagain the HTML website or the PDF book from the documentation source files.\n\nStatus\n======\n\nThe doxphinx project is in STABLE status.\n\nMore information\n================\n\nThe COPYING file contains the GNU License for this software.\n\nThe RELEASE file describes the main changes in this release.\n\nSee https://docs.phyglos.org/doxphinx for more information.\n",
"bugtrack_url": null,
"license": "GPL version 2",
"summary": "doxphinx for Sphinx",
"version": "1.7.0",
"project_urls": {
"Documentation": "https://docs.phyglos.org/doxphinx/",
"Homepage": "http://doxphinx.org/",
"Source Code": "https://github.com/phyglos/doxphinx/"
},
"split_keywords": [
"doxphinx",
"sphinx",
"phyglos"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4c535542376dc9d518c7a194b84de1c29420d4d56a23b6045ec3d9c2165fa2ea",
"md5": "4252a084f941e69d15b60b6e691728ee",
"sha256": "57274703246e53fdfafb341072075cfe775f26fb4bc28343afd948b9504726b5"
},
"downloads": -1,
"filename": "doxphinx-1.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4252a084f941e69d15b60b6e691728ee",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 19301,
"upload_time": "2023-05-19T03:28:35",
"upload_time_iso_8601": "2023-05-19T03:28:35.462318Z",
"url": "https://files.pythonhosted.org/packages/4c/53/5542376dc9d518c7a194b84de1c29420d4d56a23b6045ec3d9c2165fa2ea/doxphinx-1.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a77a954448306f8a6d482871c4f811aad1a4720da287a661d3f9c4e45d61c38b",
"md5": "a80761249b86506dc835eddb09e617f9",
"sha256": "75044f057be8713136b2784085eef2c8cdd5d7dc432e120b684f60473facb6a5"
},
"downloads": -1,
"filename": "doxphinx-1.7.0.tar.gz",
"has_sig": false,
"md5_digest": "a80761249b86506dc835eddb09e617f9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 16296,
"upload_time": "2023-05-19T03:28:37",
"upload_time_iso_8601": "2023-05-19T03:28:37.538177Z",
"url": "https://files.pythonhosted.org/packages/a7/7a/954448306f8a6d482871c4f811aad1a4720da287a661d3f9c4e45d61c38b/doxphinx-1.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-19 03:28:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "phyglos",
"github_project": "doxphinx",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "doxphinx"
}
JSON
