ashk-sphinx-theme


Nameashk-sphinx-theme JSON
Version 1.1.10 PyPI version JSON
download
home_pagehttps://github.com/a-ramti/ashk_sphinx_theme
SummaryRead the Docs theme for Sphinx
upload_time2023-01-09 08:50:26
maintainer
docs_urlNone
authorDave Snider, Read the Docs, Inc. & contributors
requires_python!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,>=2.7
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            **************************
Readme
**************************
this is a rtl theme for Sphinx_.
i use `Read the Docs`_ as a base. 

.. _Sphinx: http://www.sphinx-doc.org
.. _Read the Docs: http://www.readthedocs.org

Installation
================================

This theme is distributed on PyPI_ and can be installed with ``pip``:

.. code:: console

   $ pip install ashk-sphinx-theme

To use the theme in your Sphinx project, you will need to edit
your ``conf.py`` file's ``html_theme`` setting:

.. code:: python

    html_theme = "sphinx_rtd_theme"


.. _PyPI: https://pypi.python.org/pypi/sphinx_rtd_theme

Development:
================================

for development first read `configuring the theme`_ .

tip: for upgrade and upload to pypi remember to change the version in both files: setup.cfg & setup.py



use python3.10

make a venv:

.. code:: bash

    python3.10 -m venv vevn
    source venv/bin/activate
    pip install -e '.[dev]'

if there was a problem with installation use you may want to use this:

.. code:: bash

    npm install webpack webpack-dev-server webpack-cli --save-dev
    webpack-dev-server --open --config webpack.dev.js
    python -m pip install build twine


.. code:: bash

    npm install
    npm run build
    python setup.py sdist bdist_wheel


.. _configuring the theme: https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html


Releasing the theme
================================
for release the theme use:

.. code:: bash

    rm -rf dist/
    python setup.py sdist bdist_wheel
    twine upload -r pypi --verbose dist/*

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/a-ramti/ashk_sphinx_theme",
    "name": "ashk-sphinx-theme",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,>=2.7",
    "maintainer_email": "",
    "keywords": "",
    "author": "Dave Snider, Read the Docs, Inc. & contributors",
    "author_email": "dev@readthedocs.org",
    "download_url": "https://files.pythonhosted.org/packages/97/f6/9f6ff55f07820bb9474b12aaf4ba025c83fe07a4957d15536359c887d3fb/ashk_sphinx_theme-1.1.10.tar.gz",
    "platform": null,
    "description": "**************************\nReadme\n**************************\nthis is a rtl theme for Sphinx_.\ni use `Read the Docs`_ as a base. \n\n.. _Sphinx: http://www.sphinx-doc.org\n.. _Read the Docs: http://www.readthedocs.org\n\nInstallation\n================================\n\nThis theme is distributed on PyPI_ and can be installed with ``pip``:\n\n.. code:: console\n\n   $ pip install ashk-sphinx-theme\n\nTo use the theme in your Sphinx project, you will need to edit\nyour ``conf.py`` file's ``html_theme`` setting:\n\n.. code:: python\n\n    html_theme = \"sphinx_rtd_theme\"\n\n\n.. _PyPI: https://pypi.python.org/pypi/sphinx_rtd_theme\n\nDevelopment:\n================================\n\nfor development first read `configuring the theme`_ .\n\ntip: for upgrade and upload to pypi remember to change the version in both files: setup.cfg & setup.py\n\n\n\nuse python3.10\n\nmake a venv:\n\n.. code:: bash\n\n    python3.10 -m venv vevn\n    source venv/bin/activate\n    pip install -e '.[dev]'\n\nif there was a problem with installation use you may want to use this:\n\n.. code:: bash\n\n    npm install webpack webpack-dev-server webpack-cli --save-dev\n    webpack-dev-server --open --config webpack.dev.js\n    python -m pip install build twine\n\n\n.. code:: bash\n\n    npm install\n    npm run build\n    python setup.py sdist bdist_wheel\n\n\n.. _configuring the theme: https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html\n\n\nReleasing the theme\n================================\nfor release the theme use:\n\n.. code:: bash\n\n    rm -rf dist/\n    python setup.py sdist bdist_wheel\n    twine upload -r pypi --verbose dist/*\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Read the Docs theme for Sphinx",
    "version": "1.1.10",
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c7ddf32f52b8de88bef2c3387c245ebe559a804f2afec10abe34d5540bdd8c49",
                "md5": "6b2cc9edb00cbe9d4d3c56eb4a2d4506",
                "sha256": "14743284cb97982ac4c99c3db3d8420ae37b1996f2434e9ae284c817c8c9a33e"
            },
            "downloads": -1,
            "filename": "ashk_sphinx_theme-1.1.10-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6b2cc9edb00cbe9d4d3c56eb4a2d4506",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,>=2.7",
            "size": 3269120,
            "upload_time": "2023-01-09T08:50:20",
            "upload_time_iso_8601": "2023-01-09T08:50:20.037144Z",
            "url": "https://files.pythonhosted.org/packages/c7/dd/f32f52b8de88bef2c3387c245ebe559a804f2afec10abe34d5540bdd8c49/ashk_sphinx_theme-1.1.10-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "97f69f6ff55f07820bb9474b12aaf4ba025c83fe07a4957d15536359c887d3fb",
                "md5": "1e72219404a45a24c10d372a24994ca2",
                "sha256": "1e02252dce5a2a5870d36dc893b29b54f80787888e21530878afe5c1dc88bb81"
            },
            "downloads": -1,
            "filename": "ashk_sphinx_theme-1.1.10.tar.gz",
            "has_sig": false,
            "md5_digest": "1e72219404a45a24c10d372a24994ca2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,>=2.7",
            "size": 3229226,
            "upload_time": "2023-01-09T08:50:26",
            "upload_time_iso_8601": "2023-01-09T08:50:26.917847Z",
            "url": "https://files.pythonhosted.org/packages/97/f6/9f6ff55f07820bb9474b12aaf4ba025c83fe07a4957d15536359c887d3fb/ashk_sphinx_theme-1.1.10.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-01-09 08:50:26",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "a-ramti",
    "github_project": "ashk_sphinx_theme",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "circle": true,
    "tox": true,
    "lcname": "ashk-sphinx-theme"
}
        
Elapsed time: 0.03186s