From f797cc0a4de6c6b45e650d58c05d92ccef731e8e Mon Sep 17 00:00:00 2001 From: Leandro Lucarella Date: Thu, 15 Oct 2020 13:42:39 +0200 Subject: [PATCH] Revamp the looks of the page Use the https://github.com/guzzle/guzzle_sphinx_theme that is more clean and it's supposed to be mobile-friendly. --- README | 6 ++++++ source/_templates/layout.html | 15 -------------- source/_templates/sidebar_donate.html | 7 +++++++ source/conf.py | 30 ++++++++++++++++++--------- source/index.rst | 21 +------------------ 5 files changed, 34 insertions(+), 45 deletions(-) create mode 100644 README delete mode 100644 source/_templates/layout.html create mode 100644 source/_templates/sidebar_donate.html diff --git a/README b/README new file mode 100644 index 0000000..89ab59b --- /dev/null +++ b/README @@ -0,0 +1,6 @@ +# Dependencies + +To build this website, at least these packages are needed: + +* `apt install python3-sphinx` +* `pip install guzzle_sphinx_theme` diff --git a/source/_templates/layout.html b/source/_templates/layout.html deleted file mode 100644 index 1f2c743..0000000 --- a/source/_templates/layout.html +++ /dev/null @@ -1,15 +0,0 @@ -{% extends "!layout.html" %} - -{% block header %} -
- Leandro Lucarella's Home Page -   - Donate - Donate - Donate -
-{% endblock %} - -{%- block sidebarsearch %} -{%- endblock %} - diff --git a/source/_templates/sidebar_donate.html b/source/_templates/sidebar_donate.html new file mode 100644 index 0000000..d190b79 --- /dev/null +++ b/source/_templates/sidebar_donate.html @@ -0,0 +1,7 @@ + diff --git a/source/conf.py b/source/conf.py index e7f1b99..5684c71 100644 --- a/source/conf.py +++ b/source/conf.py @@ -12,6 +12,7 @@ # serve to show the default. import sys, os +import guzzle_sphinx_theme # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the @@ -37,7 +38,7 @@ source_suffix = '.rst' master_doc = 'index' # General information about the project. -project = u'Lala' +project = u'Leandro Lucarella' copyright = u'2009, Leandro Lucarella' # The version info for the project you're documenting, acts as replacement for @@ -89,24 +90,28 @@ pygments_style = 'sphinx' # -- Options for HTML output --------------------------------------------------- +# Register the theme as an extension to generate a sitemap.xml +extensions.append("guzzle_sphinx_theme") + # The theme to use for HTML and HTML Help pages. Major themes that come with # Sphinx are currently 'default' and 'sphinxdoc'. -html_theme = 'default' +html_theme = 'guzzle_sphinx_theme' -# Theme options are theme-specific and customize the look and feel of a theme -# further. For a list of options available for each theme, see the -# documentation. -#html_theme_options = {} +# Guzzle theme options (see theme.conf for more information) +html_theme_options = { + # Set the name of the project to appear in the sidebar + "project_nav_name": "Leandro Lucarella", +} # Add any paths that contain custom themes here, relative to this directory. -#html_theme_path = [] +html_theme_path = guzzle_sphinx_theme.html_theme_path() # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". -html_title = "Leandro Lucarella's Home Page" +html_title = "Leandro Lucarella" # A shorter title for the navigation bar. Default is the same as html_title. -html_short_title = "Home" +html_short_title = "Luca's Web" # The name of an image file (relative to this directory) to place at the top # of the sidebar. @@ -131,7 +136,12 @@ html_static_path = ['_static'] #html_use_smartypants = True # Custom sidebar templates, maps document names to template names. -#html_sidebars = {} +html_sidebars = { '**': [ + 'logo-text.html', + 'globaltoc.html', + 'searchbox.html', + 'sidebar_donate.html', +] } # Additional templates that should be rendered to pages, maps page names to # template names. diff --git a/source/index.rst b/source/index.rst index 57a1377..34ac290 100644 --- a/source/index.rst +++ b/source/index.rst @@ -17,16 +17,7 @@ for now. These are the things you can do: * Read my :doc:`resume/index` / `LinkedIn profile `_. * Look at my `public photos collection`__. * See my :doc:`projects ` and Git__ / GitHub__ / GitLab__ repositories. -* :ref:`Search ` for something in particular [*]_. -* .. raw:: html - - +* Search this website `using Google`__ (the local search is a bit limited). __ blog/ __ http://llucax.newsblur.com/ @@ -34,16 +25,6 @@ __ https://www.flickr.com/photos/llucax/albums __ https://git.llucax.com/ __ https://github.com/llucax __ https://gitlab.com/llucax - - -.. [*] Sphinx_-generated pages only. Use the `big G`__ to `search the whole - site`__. - -__ http://www.google.com/ __ https://www.google.com/search?q=site%3Allucax.com - -.. _sphinx: http://sphinx.pocoo.org/ - - .. vim: set et sw=3 sts=3 tw=78 : -- 2.43.0