From 7326894353e22c5fb64264fbe4b67dd0ad9e4de9 Mon Sep 17 00:00:00 2001 From: Alex Kelly Date: Mon, 4 Oct 2021 12:18:43 -0400 Subject: [PATCH] docs: enable rtd theme --- docs/source/conf.py | 16 +++++++++------- docs/source/introduction.rst | 4 ++++ poetry.lock | 21 ++++++++++++++++++++- pyproject.toml | 1 + 4 files changed, 34 insertions(+), 8 deletions(-) create mode 100644 docs/source/introduction.rst diff --git a/docs/source/conf.py b/docs/source/conf.py index 78b9057..be9b10c 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -16,13 +16,14 @@ # -- Project information ----------------------------------------------------- +import sphinx_rtd_theme -project = 'checkcert' -copyright = '2021, Alex Kelly' -author = 'Alex Kelly' +project = "checkcert" +copyright = "2021, Alex Kelly" +author = "Alex Kelly" # The full version, including alpha/beta/rc tags -release = '0.5.0' +release = "0.5.0" # -- General configuration --------------------------------------------------- @@ -31,10 +32,11 @@ release = '0.5.0' # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ + "sphinx_rtd_theme", ] # Add any paths that contain templates here, relative to this directory. -templates_path = ['_templates'] +templates_path = ["_templates"] # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. @@ -47,9 +49,9 @@ exclude_patterns = [] # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. # -html_theme = 'alabaster' +html_theme = "sphinx_rtd_theme" # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ['_static'] \ No newline at end of file +html_static_path = ["_static"] diff --git a/docs/source/introduction.rst b/docs/source/introduction.rst new file mode 100644 index 0000000..baba2ed --- /dev/null +++ b/docs/source/introduction.rst @@ -0,0 +1,4 @@ +Introduction +============ + +checkcert is a CLI to check a remote site secured with a certificate. It will allow you to get basic information about the certificate, if it is currently valid, any subjectAlternateNames that are present, and output content for ingestion into other utilities diff --git a/poetry.lock b/poetry.lock index 97f9ace..d0e1d94 100644 --- a/poetry.lock +++ b/poetry.lock @@ -672,6 +672,21 @@ docs = ["sphinxcontrib-websupport"] lint = ["flake8 (>=3.5.0)", "isort", "mypy (>=0.900)", "docutils-stubs", "types-typed-ast", "types-pkg-resources", "types-requests"] test = ["pytest", "pytest-cov", "html5lib", "cython", "typed-ast"] +[[package]] +name = "sphinx-rtd-theme" +version = "1.0.0" +description = "Read the Docs theme for Sphinx" +category = "dev" +optional = false +python-versions = ">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*" + +[package.dependencies] +docutils = "<0.18" +sphinx = ">=1.6" + +[package.extras] +dev = ["transifex-client", "sphinxcontrib-httpdomain", "bump2version"] + [[package]] name = "sphinxcontrib-applehelp" version = "1.0.2" @@ -854,7 +869,7 @@ testing = ["pytest (>=4.6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytes [metadata] lock-version = "1.1" python-versions = "^3.9" -content-hash = "83eb072728504c8b6d08f07db01396bd7bccd29fa73a938e36be0e0f12495bca" +content-hash = "01f9486cf3b3cb666f32f2bd4975cfdc04f41388ea389538fe428de252a0f782" [metadata.files] alabaster = [ @@ -1245,6 +1260,10 @@ sphinx = [ {file = "Sphinx-4.2.0-py3-none-any.whl", hash = "sha256:98a535c62a4fcfcc362528592f69b26f7caec587d32cd55688db580be0287ae0"}, {file = "Sphinx-4.2.0.tar.gz", hash = "sha256:94078db9184491e15bce0a56d9186e0aec95f16ac20b12d00e06d4e36f1058a6"}, ] +sphinx-rtd-theme = [ + {file = "sphinx_rtd_theme-1.0.0-py2.py3-none-any.whl", hash = "sha256:4d35a56f4508cfee4c4fb604373ede6feae2a306731d533f409ef5c3496fdbd8"}, + {file = "sphinx_rtd_theme-1.0.0.tar.gz", hash = "sha256:eec6d497e4c2195fa0e8b2016b337532b8a699a68bcb22a512870e16925c6a5c"}, +] sphinxcontrib-applehelp = [ {file = "sphinxcontrib-applehelp-1.0.2.tar.gz", hash = "sha256:a072735ec80e7675e3f432fcae8610ecf509c5f1869d17e2eecff44389cdbc58"}, {file = "sphinxcontrib_applehelp-1.0.2-py2.py3-none-any.whl", hash = "sha256:806111e5e962be97c29ec4c1e7fe277bfd19e9652fb1a4392105b43e01af885a"}, diff --git a/pyproject.toml b/pyproject.toml index 25c412b..2f4cff8 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -19,6 +19,7 @@ pylint = "^2.11.1" pyflakes = "^2.3.1" pytest = "^6.2.5" Sphinx = "^4.2.0" +sphinx-rtd-theme = "^1.0.0" [build-system] requires = ["poetry-core>=1.0.0"]