Skip to content

Commit

Permalink
Merge pull request #37 from jedymatt/26-reorganize-docs-directory-str…
Browse files Browse the repository at this point in the history
…ucture-to-default

26 reorganize docs directory structure to default
  • Loading branch information
jedymatt committed May 27, 2022
2 parents e77d7f5 + 65fc5b3 commit a71895f
Show file tree
Hide file tree
Showing 12 changed files with 17 additions and 17 deletions.
6 changes: 3 additions & 3 deletions .readthedocs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ version: 2

# Build documentation in the docs/ directory with Sphinx
sphinx:
configuration: docs/source/conf.py
builder: singlehtml
# fail_on_warning: true
configuration: docs/conf.py
builder: html
# fail_on_warning: true

# Optionally build your docs in additional formats such as PDF
formats: all
Expand Down
4 changes: 2 additions & 2 deletions docs/Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@
# from the environment for the first two.
SPHINXOPTS ?=
SPHINXBUILD ?= sphinx-build
SOURCEDIR = source
BUILDDIR = build
SOURCEDIR = .
BUILDDIR = _build

# Put it first so that "make" without argument is like "make help".
help:
Expand Down
File renamed without changes.
10 changes: 5 additions & 5 deletions docs/source/conf.py → docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
# -- Project information -----------------------------------------------------

project = 'sqlalchemyseed'
copyright = '2021, jedymatt'
copyright = '2022, jedymatt'
author = 'jedymatt'


Expand All @@ -37,18 +37,18 @@
# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
# This pattern also affects html_static_path and html_extra_path.
exclude_patterns = []
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']


# -- Options for HTML output -------------------------------------------------

# 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"
# html_theme = 'alabaster'
html_theme = 'furo'

# 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']
html_static_path = ['_static']
File renamed without changes.
4 changes: 2 additions & 2 deletions docs/source/index.rst → docs/index.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
.. sqlalchemyseed documentation master file, created by
sphinx-quickstart on Sat Sep 25 14:41:54 2021.
sphinx-quickstart on Fri May 27 23:04:46 2022.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Expand All @@ -15,7 +15,7 @@ Project Links: `Github`_ | `PyPI`_

.. toctree::
:maxdepth: 2
:caption: Contents
:caption: Contents:

intro
seeding
Expand Down
File renamed without changes.
8 changes: 4 additions & 4 deletions docs/make.bat
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,8 @@ REM Command file for Sphinx documentation
if "%SPHINXBUILD%" == "" (
set SPHINXBUILD=sphinx-build
)
set SOURCEDIR=source
set BUILDDIR=build

if "%1" == "" goto help
set SOURCEDIR=.
set BUILDDIR=_build

%SPHINXBUILD% >NUL 2>NUL
if errorlevel 9009 (
Expand All @@ -25,6 +23,8 @@ if errorlevel 9009 (
exit /b 1
)

if "%1" == "" goto help

%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
goto end

Expand Down
File renamed without changes.
2 changes: 1 addition & 1 deletion docs/requirements.txt
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
sphinx_rtd_theme>=1.0
sphinx>=4.3
furo
File renamed without changes.
Empty file removed docs/source/_static/.gitkeep
Empty file.

0 comments on commit a71895f

Please sign in to comment.