.. Edit with care, this file is included in the documentation.
Dokang
######
Dokang is a lightweight documentation repository. It is a web
application that:
1. Provides an endpoint for clients to upload their documentation.
Sending documentation to Dokang is as simple as issuing a POST
query such as:
.. code:: bash
$ curl \
-X POST \
--form name=project_name \
-F ":action=doc_upload" \
-F content=@../documentation.zip \
http://dokang:my-secret-token@dokang.example.com/upload
2. Serves a home page with a list of all documentations and a simple
search form that lets users search in HTML, text and PDF
files. Other formats can be handled through the use of extensions.
3. Serves all documentations.
Dokang also comes with a command line interface. It is lightweight in
the sense that it is merely a wrapper around the Whoosh search engine
with a very simple HTML text indexer. It can be extended to retrieve
content from other types of files (such as PDF).
Dokang is similar to Readthedocs (although Readthedocs has a much
broader set of features) but provides a global search across all
hosted documentations. All of this is provided with a simple setup
that does not need any relational database.
We (`Polyconseil`_) use it to search through the `Sphinx
<http://sphinx-doc.org/>`_-generated documentation of all our
projects. However, it may be used to host any kind of documentation.
.. _Polyconseil: https://www.polyconseil.fr/
Build and run your own docker image
-----------------------------------
To build your own image:
.. code:: bash
$ docker build -t dokang .
To run the image:
.. code:: bash
$ docker run --rm -e DOKANG_UPLOAD_TOKEN=my_little_secret \
-e DOKANG_NAME='My docs' \
-e DOKANG_DESCRIPTION='Documentations of all my projects' \
-e DOKANG_SERVER_TRUSTED_PROXY=129.14.12.1 # Optional: the IP address of the proxy to pass to waitress server's trusted_proxy
-p 8080:6543
dokang
Go to http://localhost:8080/ in your browser, you should see the list of documentations.
Change log
==========
0.10.1 (2023-02-10)
-------------------
- Fix selection of options (on the main page)
0.10.0 (2023-02-09)
-------------------
- Bump dependencies
- Support of Python 3.7 and 3.8
- Drop support of Python <=3.6
- Fix OpenSearch view in Python 3.
0.9.5 (2016-12-14)
------------------
- Improve data repository initialization.
0.9.4 (2016-07-05)
------------------
- fix dockerfile.
0.9.3 (2016-07-04)
------------------
- Add dockerfile.
0.9.2 (2016-04-26)
------------------
- Keep title when updating documentation.
0.9.1 (2016-04-01)
------------------
- Fix packaging
0.9.0 (2016-04-01)
------------------
- Allow running simultaneous threads of Dokang web application.
Until now, Dokang updated its list of document sets at startup and
when a new document set was uploaded. Running multiple threads of
the web application was obviously not working great, as one thread
would not see any new document set if it was added by another
thread.
This limitation has now been lifted and Dokang web application can
run with multiple threads (for example with multiple uWSGI workers).
Dokang 0.8.2 (2016-02-24)
-------------------------
- Update doc set title after uploading a new version of the documentation.
Dokang 0.8.1 (2016-02-24)
-------------------------
- Fix packaging.
Dokang 0.8.0 (2016-02-24)
-------------------------
- Use the title of the index page as the title of each doc set.
- Group doc sets by the first letter of their title.
Dokang 0.7.0 (2016-02-01)
-------------------------
- Add support of Python 3.5.
- When initializing the index, ``dokang init`` now creates all needed
intermediate-level directories.
- Add purge option to ``dokang clear`` to delete uploaded files.
- Fix change detection: we used to store and use the modification time
of the files. We now compute and store an MD5 hash for each file. It
is slower than getting the modification time, but it handles more
use cases.
**This is a backward-incompatible change.** You must reindex all
documents, like this::
dokang init --force
dokang index
- Remove bogus indexation optimization. The indexation should be a lot
faster now, especially on large document base.
- Fix encoding error when parsing non ASCII, non UTF-8 HTML files.
UTF-8 files were correctly processed, though.
- Add basic support for OpenSearch.
- Exclude more Sphinx-generated files like ``objects.inv`` and
``searchindex.js``.
- Display path of files in the search results of the command line
client.
- Fix bug in document deletion. When a document was detected as
deleted from a document set (i.e. when a file was not present
anymore in the "upload" directory), the indexation process deleted
from the index *all* documents with the same path (for example
``index.html``) in *all* document sets. The files themselves were
not deleted so the next indexation would add them back to the index.
- Use an asynchronous index writer that allows multiple indexation to
be done concurrently. Without this, a ``whoosh.index.LockError``
exception is raised.
Dokang 0.6.1 (2015-03-03)
-------------------------
- Fix redirection error when uploading documentation.
Dokang 0.6.0 (2015-03-03)
-------------------------
**Brown bag release.**
- Drop Python 2.6 support.
- Make documentation available from the root of Dokang ("/"). This
change is backward-incompatible.
Before this commit, if the upload dir was named "uploaded", the
documentation would be available at ``/uploaded/<doc_set_id>``. This
was a bit too verbose.
With this (backward-incompatible) change, the documentation is now
available at ``/<doc_set_id>``.
Dokang 0.5.0 (2015-02-18)
-------------------------
- Add "highlight" in the query string of the URLs of search results.
This parameter is understood by Sphinx-generated HTML files.
- Add documentation uploading end point (to use Dokang web frontend to serve the documentation)
Dokang 0.4.2 (2014-09-01)
-------------------------
- Fix bad-looking (but working) URLs generated in the web front-end.
They used to contain two consecutive slashes (for example
http://example.com/project//doc.html) when the configuration of the
project had a slash at the end of its URL.
Dokang 0.4.1 (2014-08-27)
-------------------------
- Fixed MANIFEST.in so that the Python package contains all templates
and stylesheets required by the web front-end.
Dokang 0.4.0 (2014-07-04)
-------------------------
- A new ``dokang.hit_limit`` option has been added to the INI
configuration file. It limits the number of results shown on the web
front-end (or lifts this limit if the option is absent).
Dokang 0.3.0 (2014-07-04)
-------------------------
- Fix bug in the HTML harvester. Trying to use it would fail with an
exception because Whoosh would complain about something that
unexpectedly is a byte string.
- Fix bug in the handling of deleted documents. They were not deleted
from the index.
Dokang 0.2.0 (2014-06-24)
-------------------------
Initial version.
Raw data
{
"_id": null,
"home_page": "https://dokang.readthedocs.io/",
"name": "Dokang",
"maintainer": "",
"docs_url": "https://pythonhosted.org/Dokang/",
"requires_python": "",
"maintainer_email": "",
"keywords": "documentation repository search engine",
"author": "Polyconseil",
"author_email": "opensource+dokang@polyconseil.fr",
"download_url": "",
"platform": null,
"description": ".. Edit with care, this file is included in the documentation.\n\nDokang\n######\n\nDokang is a lightweight documentation repository. It is a web\napplication that:\n\n1. Provides an endpoint for clients to upload their documentation.\n\n Sending documentation to Dokang is as simple as issuing a POST\n query such as:\n\n .. code:: bash\n\n $ curl \\\n -X POST \\\n --form name=project_name \\\n -F \":action=doc_upload\" \\\n -F content=@../documentation.zip \\\n http://dokang:my-secret-token@dokang.example.com/upload\n\n2. Serves a home page with a list of all documentations and a simple\n search form that lets users search in HTML, text and PDF\n files. Other formats can be handled through the use of extensions.\n\n3. Serves all documentations.\n\nDokang also comes with a command line interface. It is lightweight in\nthe sense that it is merely a wrapper around the Whoosh search engine\nwith a very simple HTML text indexer. It can be extended to retrieve\ncontent from other types of files (such as PDF).\n\nDokang is similar to Readthedocs (although Readthedocs has a much\nbroader set of features) but provides a global search across all\nhosted documentations. All of this is provided with a simple setup\nthat does not need any relational database.\n\nWe (`Polyconseil`_) use it to search through the `Sphinx\n<http://sphinx-doc.org/>`_-generated documentation of all our\nprojects. However, it may be used to host any kind of documentation.\n\n.. _Polyconseil: https://www.polyconseil.fr/\n\n\nBuild and run your own docker image\n-----------------------------------\n\nTo build your own image:\n\n.. code:: bash\n\n $ docker build -t dokang .\n\nTo run the image:\n\n.. code:: bash\n\n $ docker run --rm -e DOKANG_UPLOAD_TOKEN=my_little_secret \\\n -e DOKANG_NAME='My docs' \\\n -e DOKANG_DESCRIPTION='Documentations of all my projects' \\\n -e DOKANG_SERVER_TRUSTED_PROXY=129.14.12.1 # Optional: the IP address of the proxy to pass to waitress server's trusted_proxy\n -p 8080:6543\n dokang\n\nGo to http://localhost:8080/ in your browser, you should see the list of documentations.\n\nChange log\n==========\n\n0.10.1 (2023-02-10)\n-------------------\n\n- Fix selection of options (on the main page)\n\n0.10.0 (2023-02-09)\n-------------------\n\n- Bump dependencies\n- Support of Python 3.7 and 3.8\n- Drop support of Python <=3.6\n- Fix OpenSearch view in Python 3.\n\n\n0.9.5 (2016-12-14)\n------------------\n\n- Improve data repository initialization.\n\n\n0.9.4 (2016-07-05)\n------------------\n\n- fix dockerfile.\n\n\n0.9.3 (2016-07-04)\n------------------\n\n- Add dockerfile.\n\n\n0.9.2 (2016-04-26)\n------------------\n\n- Keep title when updating documentation.\n\n\n0.9.1 (2016-04-01)\n------------------\n\n- Fix packaging\n\n\n0.9.0 (2016-04-01)\n------------------\n\n- Allow running simultaneous threads of Dokang web application.\n\n Until now, Dokang updated its list of document sets at startup and\n when a new document set was uploaded. Running multiple threads of\n the web application was obviously not working great, as one thread\n would not see any new document set if it was added by another\n thread.\n\n This limitation has now been lifted and Dokang web application can\n run with multiple threads (for example with multiple uWSGI workers).\n\n\nDokang 0.8.2 (2016-02-24)\n-------------------------\n\n- Update doc set title after uploading a new version of the documentation.\n\n\nDokang 0.8.1 (2016-02-24)\n-------------------------\n\n- Fix packaging.\n\n\nDokang 0.8.0 (2016-02-24)\n-------------------------\n\n- Use the title of the index page as the title of each doc set.\n- Group doc sets by the first letter of their title.\n\nDokang 0.7.0 (2016-02-01)\n-------------------------\n\n- Add support of Python 3.5.\n\n- When initializing the index, ``dokang init`` now creates all needed\n intermediate-level directories.\n\n- Add purge option to ``dokang clear`` to delete uploaded files.\n\n- Fix change detection: we used to store and use the modification time\n of the files. We now compute and store an MD5 hash for each file. It\n is slower than getting the modification time, but it handles more\n use cases.\n\n **This is a backward-incompatible change.** You must reindex all\n documents, like this::\n\n dokang init --force\n dokang index\n\n- Remove bogus indexation optimization. The indexation should be a lot\n faster now, especially on large document base.\n\n- Fix encoding error when parsing non ASCII, non UTF-8 HTML files.\n UTF-8 files were correctly processed, though.\n\n- Add basic support for OpenSearch.\n\n- Exclude more Sphinx-generated files like ``objects.inv`` and\n ``searchindex.js``.\n\n- Display path of files in the search results of the command line\n client.\n\n- Fix bug in document deletion. When a document was detected as\n deleted from a document set (i.e. when a file was not present\n anymore in the \"upload\" directory), the indexation process deleted\n from the index *all* documents with the same path (for example\n ``index.html``) in *all* document sets. The files themselves were\n not deleted so the next indexation would add them back to the index.\n\n- Use an asynchronous index writer that allows multiple indexation to\n be done concurrently. Without this, a ``whoosh.index.LockError``\n exception is raised.\n\n\nDokang 0.6.1 (2015-03-03)\n-------------------------\n\n- Fix redirection error when uploading documentation.\n\n\nDokang 0.6.0 (2015-03-03)\n-------------------------\n\n**Brown bag release.**\n\n- Drop Python 2.6 support.\n\n- Make documentation available from the root of Dokang (\"/\"). This\n change is backward-incompatible.\n\n Before this commit, if the upload dir was named \"uploaded\", the\n documentation would be available at ``/uploaded/<doc_set_id>``. This\n was a bit too verbose.\n\n With this (backward-incompatible) change, the documentation is now\n available at ``/<doc_set_id>``.\n\n\nDokang 0.5.0 (2015-02-18)\n-------------------------\n\n- Add \"highlight\" in the query string of the URLs of search results.\n This parameter is understood by Sphinx-generated HTML files.\n\n- Add documentation uploading end point (to use Dokang web frontend to serve the documentation)\n\n\nDokang 0.4.2 (2014-09-01)\n-------------------------\n\n- Fix bad-looking (but working) URLs generated in the web front-end.\n They used to contain two consecutive slashes (for example\n http://example.com/project//doc.html) when the configuration of the\n project had a slash at the end of its URL.\n\n\nDokang 0.4.1 (2014-08-27)\n-------------------------\n\n- Fixed MANIFEST.in so that the Python package contains all templates\n and stylesheets required by the web front-end.\n\n\nDokang 0.4.0 (2014-07-04)\n-------------------------\n\n- A new ``dokang.hit_limit`` option has been added to the INI\n configuration file. It limits the number of results shown on the web\n front-end (or lifts this limit if the option is absent).\n\n\nDokang 0.3.0 (2014-07-04)\n-------------------------\n\n- Fix bug in the HTML harvester. Trying to use it would fail with an\n exception because Whoosh would complain about something that\n unexpectedly is a byte string.\n\n- Fix bug in the handling of deleted documents. They were not deleted\n from the index.\n\n\nDokang 0.2.0 (2014-06-24)\n-------------------------\n\nInitial version.\n",
"bugtrack_url": null,
"license": "",
"summary": "Lightweight web documentation repository with a search engine",
"version": "0.10.1",
"split_keywords": [
"documentation",
"repository",
"search",
"engine"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5d65e5cc757a56f861bd2321d52efef825eecb58af92369b39e473c9f998a8ab",
"md5": "d4c45c954f9ca14eade8b79e6e5e5995",
"sha256": "51b0f02a4f0d8b757395502ff4094f4635df434311e55d52c309f4cd1e41cfad"
},
"downloads": -1,
"filename": "Dokang-0.10.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d4c45c954f9ca14eade8b79e6e5e5995",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 23670,
"upload_time": "2023-02-10T18:34:13",
"upload_time_iso_8601": "2023-02-10T18:34:13.351191Z",
"url": "https://files.pythonhosted.org/packages/5d/65/e5cc757a56f861bd2321d52efef825eecb58af92369b39e473c9f998a8ab/Dokang-0.10.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-10 18:34:13",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "dokang"
}
JSON