Skip to content

Commit 7fd2041

Browse files
author
Anastasia Alexadrova
committed
DEploying docs on Netlify
1 parent 21157f8 commit 7fd2041

File tree

9 files changed

+153
-2
lines changed

9 files changed

+153
-2
lines changed

‎.gitignore

+4-1
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,7 @@
22
build/
33
source/ext/psdom.pyc
44
source/ext/__pycache__/
5-
source/percona-theme/
5+
source/percona-theme/
6+
source/__pycache__/
7+
# Local Netlify folder
8+
.netlify

‎Makefile

+5
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,11 @@ html:
5151
@echo
5252
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
5353

54+
netlify:
55+
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) -c source/conf-netlify $(BUILDDIR)/html
56+
@echo
57+
@echo "Netlify build finished. The HTML pages are in $(BUILDDIR)/html."
58+
5459
thtml:
5560
@echo "Building themed html doc"
5661
$(SPHINXBUILD) -D html_theme=alabaster -D html_theme_path='' -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html

‎requirements.txt

+50
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
alabaster==0.7.12
2+
Babel==2.8.0
3+
beautifulsoup4==4.9.3
4+
certifi==2020.6.20
5+
chardet==3.0.4
6+
click==7.1.2
7+
css-html-js-minify==2.5.5
8+
Deprecated==1.2.10
9+
docutils==0.16
10+
Flask==1.1.2
11+
gitdb==4.0.5
12+
GitPython==3.1.13
13+
idna==2.10
14+
imagesize==1.2.0
15+
inflection==0.5.1
16+
itsdangerous==1.1.0
17+
Jinja2==2.11.2
18+
livereload==2.6.3
19+
lxml==4.6.2
20+
MarkupSafe==1.1.1
21+
packaging==20.4
22+
py-buzz==2.0.0
23+
Pygments==2.6.1
24+
pyparsing==2.4.7
25+
python-slugify==4.0.1
26+
pytz==2020.1
27+
requests==2.24.0
28+
six==1.15.0
29+
smmap==3.0.5
30+
snowballstemmer==2.0.0
31+
soupsieve==2.1
32+
Sphinx==3.2.1
33+
sphinx-autobuild==2020.9.1
34+
sphinx-copybutton==0.3.1
35+
sphinx-gitstamp==0.3.1
36+
sphinx-material==0.0.32
37+
sphinxcontrib-applehelp==1.0.2
38+
sphinxcontrib-contentui==0.2.5
39+
sphinxcontrib-devhelp==1.0.2
40+
sphinxcontrib-fulltoc==1.2.0
41+
sphinxcontrib-htmlhelp==1.0.3
42+
sphinxcontrib-jsmath==1.0.1
43+
sphinxcontrib-qthelp==1.0.3
44+
sphinxcontrib-serializinghtml==1.1.4
45+
text-unidecode==1.3
46+
tornado==6.1
47+
Unidecode==1.1.2
48+
urllib3==1.25.10
49+
Werkzeug==1.0.1
50+
wrapt==1.12.1

‎runtime.txt

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
3.7

‎source/_static/images/percona-logo.svg

+12
Loading

‎source/_static/images/percona_favicon.ico

894 Bytes
Binary file not shown.

‎source/_templates/layout.html

+49
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
{# Import the theme's layout. #}
2+
{% extends '!layout.html' %}
3+
4+
{ # Customize font # }
5+
{% block font %}
6+
<style>
7+
body,
8+
input {
9+
font-family: "Chivo", "Helvetica Neue", Helvetica, Arial, sans-serif
10+
}
11+
12+
</style>
13+
{{ super() }}
14+
{% endblock %}
15+
16+
{ # Add Fontawesome # }
17+
{%- block fonticon %}
18+
<link href="//netdna.bootstrapcdn.com/twitter-bootstrap/2.3.2/css/bootstrap-combined.no-icons.min.css" rel="stylesheet">
19+
<link href="//netdna.bootstrapcdn.com/font-awesome/3.2.1/css/font-awesome.css" rel="stylesheet">
20+
{{ super() }}
21+
{%- endblock %}
22+
23+
{ # Adds the "Last updated label" at the bottom of the page # }
24+
{%- block relbar2 %}
25+
{%- if gitstamp %}
26+
<div class="md_container">
27+
<p><i class="fas fa-sync-alt"></i>
28+
Last updated on {{ gitstamp }}. </p>
29+
</div>
30+
{%- endif %}
31+
{{ super() }}
32+
{%- endblock%}
33+
34+
{# 'Edit this page' links #}
35+
{% block rootrellink %}
36+
{{ super() }}
37+
{% if repo_url|e %}
38+
<div class="small">
39+
<ul class="list-inline">
40+
<li class="pull-right">
41+
<a href="{{ repo_url }}/{{ edit_uri }}/{{ pagename }}.rst" target="_blank">
42+
<i class="fa fa-github"></i>
43+
Edit this page
44+
</a>
45+
</li>
46+
</ul>
47+
</div>
48+
{% endif %}
49+
{% endblock %}

‎source/conf-netlify/conf.py

+31
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
#!/usr/bin/env python3
2+
# -*- coding: utf-8 -*-
3+
import sys
4+
import os
5+
sys.path.append(os.path.abspath("../"))
6+
from conf import *
7+
extensions.append('sphinx_gitstamp')
8+
extensions.append('sphinx_copybutton')
9+
html_theme = 'sphinx_material'
10+
html_theme_options = {
11+
'base_url': 'http://bashtage.github.io/sphinx-material/',
12+
'repo_url': 'https://github.com/percona/postgresql-docs',
13+
'repo_name': 'percona/postgresql-docs',
14+
'color_accent': 'grey',
15+
'color_primary': 'orange',
16+
'globaltoc_collapse': True,
17+
'version_dropdown': True,
18+
'version_dropdown_text': 'Versions',
19+
'version_info': {
20+
"11": "https://postgresql-docs-11.netlify.app",
21+
"12": "https://postgresql-docs-12.netlify.app",
22+
"13": "https://postgresql-docs-11.netlify.app",
23+
"Latest": "https://www.percona.com/doc/postgresql/LATEST/index.html"
24+
},
25+
}
26+
html_logo = '../_static/images/percona-logo.svg'
27+
html_favicon = '../_static/images/percona_favicon.ico'
28+
pygments_style = 'emacs'
29+
gitstamp_fmt = '%b %d, %Y'
30+
copybutton_prompt_text = '$'
31+
#html_last_updated_fmt = ''

‎source/conf.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,7 @@
155155

156156
# Custom sidebar templates, maps document names to template names.
157157
html_sidebars = {
158-
'**': ['localtoc.html', 'relations.html', 'sourcelink.html', 'edit.html'],
158+
'**': ['localtoc.html', 'relations.html', 'sourcelink.html', 'edit.html', 'searchbox.html', 'globaltoc.html'],
159159
'using/windows': ['windowssidebar.html'],
160160
}
161161

0 commit comments

Comments
 (0)