mirror of
https://github.com/ThePhD/sol2.git
synced 2024-03-22 13:10:44 +08:00
readme
This commit is contained in:
parent
3d2de738e0
commit
a2cbb0fbf0
|
@ -1,4 +0,0 @@
|
|||
sphinx-rtd-theme
|
||||
================
|
||||
|
||||
Sphinx theme for readthedocs.org
|
39
README.rst
Normal file
39
README.rst
Normal file
|
@ -0,0 +1,39 @@
|
|||
.. _readthedocs.org: http://www.readthedocs.org
|
||||
.. _bower: http://www.bower.io
|
||||
.. _sphinx: http://www.sphinx-doc.org
|
||||
.. _compass: http://www.compass-style.org
|
||||
|
||||
**************************
|
||||
Read the Docs Sphinx Theme
|
||||
**************************
|
||||
|
||||
This is a prototype mobile-friendly sphinx theme I made for _readthedocs.org. It's
|
||||
currently in development and includes some rtd variable checks that can be ignored
|
||||
if you're just tyring to use it on your project outside of that site.
|
||||
|
||||
Installation
|
||||
============
|
||||
|
||||
Symlink the ``sphinx_rtd_theme/sphinx_rtd_theme`` repository into your documentation at
|
||||
``docs/_themes/sphinx_rtd_theme`` then add the following two settings to your Sphinx
|
||||
conf.py file:
|
||||
|
||||
.. code-block::
|
||||
|
||||
html_theme = "sphinx_rtd_theme"
|
||||
html_theme_path = ["_themes", ]
|
||||
|
||||
Contributing or modifying the theme
|
||||
===================================
|
||||
|
||||
To work on this theme you'll need to install _bower. Then simply run a ``bower install`` in the
|
||||
root directory to install the dependencies. Once installed, make your sass changes to the
|
||||
``sphix_rtd_theme/sass`` directory, making sure to use _compass to compile down to css.
|
||||
|
||||
If you'd like to see your changes made to master, send me a pull request.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user