Merge branch '1.x' (fceed6d8) · Commits · Anton Smirnov / php-clock

.readthedocs.yaml

+2 −2

Original line number	Diff line number	Diff line
		version: 2

		build:
		os: 'ubuntu-22.04'
		os: 'ubuntu-24.04'
		tools:
		python: '3.11'
		python: '3.12'

		sphinx:
		configuration: 'docs/conf.py'

docs/_templates/rtd-version.html

+7 −3

Original line number	Diff line number	Diff line
		{%- if current_version -%}
		<div class="sidebar-brand">{{ current_version }}</div>
		{%- endif -%}
		<div class="navbar-brand">{{ current_version }}</div>

		{#- hack scroll issue -#}

		<style>
		#rtd-footer-container { display: none; }
		</style>

docs/conf.py

+51 −9

Original line number	Diff line number	Diff line
		@@ -6,21 +6,63 @@ sys.path.append(os.curdir)
		from conf_project import *

		author = 'Anton Smirnov'
		copyright = '{} {}'.format(datetime.now().year, author)
		copyright = '{}'.format(datetime.now().year)
		language = 'en'

		html_title = project
		html_theme = 'furo'
		html_theme = 'sphinx_book_theme'
		templates_path = ["_templates"]
		html_sidebars = {
		"**": [
		"sidebar/brand.html",
		"navbar-logo.html",
		"icon-links.html",
		"rtd-version.html",
		"sidebar/search.html",
		"sidebar/scroll-start.html",
		"sidebar/navigation.html",
		"sidebar/ethical-ads.html",
		"sidebar/scroll-end.html",
		"sidebar/variant-selector.html",
		"search-button-field.html",
		"sbt-sidebar-nav.html",
		]
		}
		html_theme_options = {
		'use_edit_page_button': True,
		'icon_links': [
		{
		"name": "GitLab",
		"url": "https://gitlab.com/sandfox/" + repo,
		"icon": "fa-brands fa-square-gitlab",
		"type": "fontawesome",
		},
		{
		"name": "GitHub",
		"url": "https://github.com/arokettu/" + repo,
		"icon": "fa-brands fa-square-github",
		"type": "fontawesome",
		},
		{
		"name": "BitBucket",
		"url": "https://bitbucket.org/sandfox/" + repo,
		"icon": "fa-brands fa-bitbucket",
		"type": "fontawesome",
		},
		{
		"name": "Gitea",
		"url": "https://sandfox.org/sandfox/" + repo,
		"icon": "fa-solid fa-mug-hot",
		"type": "fontawesome",
		},
		]
		}
		if packagist:
		html_theme_options['icon_links'].append({
		"name": "Packagist",
		"url": "https://packagist.org/packages/" + packagist,
		"icon": "https://img.shields.io/packagist/dm/" + packagist + "?style=flat-square",
		"type": "url",
		})
		html_context = {
		'current_version': os.environ.get("READTHEDOCS_VERSION_NAME"),
		'gitlab_user': "sandfox",
		'gitlab_repo': repo,
		'gitlab_version': "master",
		'doc_path': "docs",
		}

		exclude_patterns = ['venv/*']

docs/conf_project.py

+2 −0

Original line number	Diff line number	Diff line
		project = 'Clock'
		repo = 'php-clock'
		packagist = 'arokettu/clock'

docs/requirements.txt

+1 −1

Original line number	Diff line number	Diff line
		furo
		sphinx-book-theme