kujiulabs/source/conf.py

# -*- coding: utf-8 -*-
import os
import ablog
import gettext
_ = gettext.gettext

project = "Kujiu's Labs"
basename = 'kujiulabs'
project_uid = basename  # ISBN, etc.
baseurl = 'https://kujiu.eu/'
copyright = '2021, kujiu & Nerv Project ASBL - ISSN 2736-7649 - BCE 0756.741.342 - TVA BE0756741342 - KBR Éditeur 15066 - IBAN BE02751210684040 - BIC AXABBE22'
author = 'Kujiu'
publisher = 'Nerv Project ASBL'
site_url = 'https://kujiu.eu/'
vcs_uri = "https://procrastinator.nerv-project.eu/"
repository_name = 'kujiu_writer/'
repository_name += 'kujiulabs'
use_ablog = True
use_bibtex = True
use_git = True
language = 'fr'
html_extra_path = [
    "_static/robots.txt",
    "_static/favicon.ico",
]

version = "6.0"
release = "6.0"

if use_ablog:
    blog_title = project
    blog_baseurl = baseurl
    blog_default_author = 'kujiu'
    blog_default_location = 'BLA'
    blog_authors = {
        'kujiu': ('Kujiu', 'https://kujiu.eu'),
    }
    blog_locations = {
        'BLA': (
            "Braine-l'Alleud",
            "https://fr.wikipedia.org/wiki/Braine-l'Alleud"
        ),
    }
    post_date_format = 'Le %d %b %Y à %H:%M'
    post_auto_excerpt = 1
    post_auto_image = 1
    post_redirect_refresh = 5
    post_always_section = False
    post_auto_orphan = True

    blog_feed_fulltext = False
    blog_feed_subtitle = None
    blog_feed_titles = False
    blog_feed_length = 30
    fontawesome_link_cdn = None
    fontawesome_included = True
    fontawesome_css_file = ''
    show_authors = True

if use_git:
    from git import Repo

    repo = Repo(
        os.path.join(
            os.path.dirname(os.path.realpath(__file__)),
            '..'
        )
    )
    repo.config_reader()

    if not repo.head.is_detached:
        version = repo.head.ref.name
    release = version + ' [' + repo.commit().hexsha[:20] + ']'

    repository_uri = vcs_uri + repository_name
    issues_uri = repository_uri + "/issues/{issue}"
    issues_pr_uri = repository_uri + "/merge_requests/{pr}"
    issues_commit_uri = repository_uri + "/commit/{commit}"
    issues_user_uri = vcs_uri + "/{user}"

extensions = [
    'sphinxemoji.sphinxemoji',
    'sphinxcontrib.actdiag',
    'sphinxcontrib.blockdiag',
    'sphinxcontrib.nwdiag',
    'sphinxcontrib.seqdiag',
    'sphinx_galleria',
    'sphinx.ext.extlinks',
    'sphinx.ext.intersphinx',
    'sphinx.ext.todo',
    'sphinx_issues',
    'sphinx_sitemap',
    'sphinx_fasvg',
    # 'sphinx_storymaker',
]

if use_ablog:
    extensions.append('ablog')

if use_git:
    extensions.append('sphinx_git')

if use_bibtex:
    extensions.append('sphinxcontrib.bibtex')

locale_dirs = ['locale/']

if use_ablog:
    locale_dirs.append(
        os.path.join(ablog.get_html_templates_path(), '..', 'locale'),
    )

templates_path = ['_templates']

source_suffix = '.rst'
master_doc = 'index'

exclude_patterns = []
pygments_style = 'sphinx'


html_logo = '_static/logo.png'
html_theme = 'nervproject'
html_theme_options = {
    "logoalt": project,
    "social": [
        ('solid', 'barcode', 'ISSN 2736-7649', 'https://portal.issn.org/resource/ISSN/2736-7649', False),
        ('solid', 'building', 'Nerv Project ASBL', 'https://nerv-project.eu', False),
        ('solid', 'building', 'BCE 0756.741.342', 'https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?ondernemingsnummer=756741342', False),
        ('solid', 'receipt', 'TVA BE0756741342', 'https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?ondernemingsnummer=756741342', False),
        ('solid', 'books', 'KBR Éditeur 15066', 'https://www.kbr.be', False),
        ('solid', 'comment', 'xmpp', 'xmpp:kujiu@kujiu.eu', True),
        ('brands', 'mastodon', 'mastodon', 'https://tiphon.nerv-project.eu/@kujiu', True),
        ('solid', 'mug-hot', 'forgejo', 'https://procrastinator.nerv-project.eu/kujiu', True),
        ('solid', 'film', 'peertube', 'https://clap.nerv-project.eu/video-channels/kujiu_channel/videos', True),
        ('brands', 'youtube', 'youtube', 'https://www.youtube.com/channel/UC6LcFMVZUOs4WbKvV3p1xVw', True),
        ('solid', 'podcast', 'podcasts', 'https://kreskenn.nerv-project.eu/channels/kujiulabs/', True),
        ('solid', 'paragraph', 'gemini', 'gemini://kujiu.eu', False),
        ('solid', 'rss', 'rss', 'https://kujiu.eu/blog/atom.xml', False),
        ('solid', 'envelope', 'newsletter', 'https://sybil.nerv-project.eu/mailman3/lists/kujiulabs.sybil.nerv-project.eu/', False),
    ],
    'external_languages': [
        # ('code', 'name', 'baseurl'),
        ('fr', 'Français', '/fr'),
        ('en', 'English', '/en'),
    ],
    "mastodon_user": "@kujiu@tiphon.nerv-project.eu",
    "fathom": {
        'url': 'https://casanabo.kujiu.eu',
        'id': 'JKNYR',
    },
    'isso': {
        'prefix': '',
        'url': 'https://chicard.kujiu.eu',
        'require_author': "true",
        'reply_to_self': "true",
        'require_author': "true",
        'require_email': "false",
        'reply_notif': "true",
        'max_comments_top': 20,
        'max_comments_nested': 20,
        'reveal_on_click': 20,
        'avatar': "true",
        'vote': "false",
        'vote_levels': "",
        'feed': "true",
    },
    "ablog_prevnext": True,
    "license": {
        'text': 'EUPL 1.2',
        'url': "https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12"
    }
}
html_static_path = ['_static']
html_sidebars = {
    '**': [
        'about.html',
        'social.html',
        'ablog/postcard.html',
        'util/sidetoc.html',
        'ablog/recentposts.html',
        'ablog/categories.html',
        'ablog/tagcloud.html',
        'ablog/archives.html',
        'util/searchbox.html',
    ],
}
html_baseurl = baseurl

htmlhelp_basename = basename

pyppeteer_pdf_options = {
    'printBackground': True,
    'format': 'A4',
    'margin': {
        'top': '0mm',
        'bottom': '0mm',
        'left': '0mm',
        'right': '0mm'
    }
}

gemini_baseurl = "gemini://kujiu.eu/"
gemini_footer = _("""
# Menu

=> gemini://kujiu.eu Accueil
=> gemini://kujiu.eu/apropos/historique.gmi Historique
=> gemini://kujiu.eu/apropos/apropos.gmi À propos
=> gemini://kujiu.eu/apropos/mentions_legales.gmi Mentions légales
=> gemini://kujiu.eu/apropos/accessibility.gmi Déclaration d'accessibilité
=> gemini://kujiu.eu/apropos/confidentiality.gmi Déclaration deconfidentialité

=> gemini://kujiu.eu/blog/atom.xml Abonnez-vous !

=> https://kreskenn.nerv-project.eu/channels/kujiulabs/ La version podcast (HTTPS)
=> https://kujiu.eu Le site en HTTPS

=> gemini://nerv-project.eu Le Kujiu's Labs est produit par Nerv Project ASBL.

ISSN 2736-7649

Nerv Project ASBL - BCE 0756.741.342 - TVA BE0756741342 - KBR Éditeur 15066 - IBAN BE02751210684040 - BIC AXABBE22.

Licence EUPL 1.2
""")

latex_engine = 'xelatex'
latex_toplevel_sectioning = 'chapter'
latex_show_urls = 'footnote'
latex_elements = {
    # 'figure_align': 'htbp',
    # 'extraclassoptions': '',
    'papersize': 'a4paper',
    'pointsize': '12pt',
    'extraclassoptions': 'twoside',
    'fontpkg': r'''
        \defaultfontfeatures{Ligatures=TeX}
        \setmainfont{Linux Biolinum O}
        \setsansfont{Linux Biolinum O}
    '''
}
latex_show_pagerefs = True
latex_documents = [
    (master_doc, basename + '.tex', project,
     author, 'book'),
]


man_pages = [
    (master_doc, basename.lower(), project, [author], 1)
]


texinfo_documents = [
    (master_doc, basename, project,
     author, basename, '',
     'Miscellaneous'),
]


epub_title = project
epub_author = author
epub_publisher = publisher
epub_copyright = copyright

epub_identifier = project_uid
epub_uid = ''
epub_exclude_files = [
   'index.xhtml',
   'search.xhtml',
   'blog.xhtml',
   'submit_success.xhtml',
   'contact.xhtml',
   '403.xhtml',
   '404.xhtml',
   'blog/archive.xhtml',
   'blog/category.xhtml',
   'blog/drafts.xhtml',
   'blog/author.xhtml',
   'blog/language.xhtml',
   'blog/location.xhtml',
   'blog/location/braine-lalleud.xhtml',
   'blog/language/francais.xhtml',
   'blog/author/kujiu.xhtml',
   'blog/2014.xhtml',
   'blog/2015.xhtml',
   'blog/2016.xhtml',
   'blog/2017.xhtml',
   'blog/2018.xhtml',
   'blog/2019.xhtml',
   'blog/2020.xhtml',
   'blog/2021.xhtml',
   'blog/2022.xhtml',
   'blog/2023.xhtml',
   'blog/2024.xhtml',
   'google82f190054a773ed9.xhtml',
   'robots.txt',
]
epub_theme = 'nervproject'
epub_theme_options = html_theme_options
epub_show_urls = 'footnote'

diag_antialias = True
diag_transparency = True
diag_html_image_format = "SVG"
diag_latex_image_format = "PDF"
diag_fontpath = os.path.dirname(os.path.realpath(__file__))
diag_fontpath = os.path.join(diag_fontpath, '_static', 'biolinumrah.ttf')
diag_debug = False

actdiag_antialias = diag_antialias
actdiag_transparency = diag_transparency
actdiag_html_image_format = diag_html_image_format
actdiag_latex_image_format = diag_latex_image_format
actdiag_fontpath = diag_fontpath
actdiag_debug = diag_debug

blockdiag_antialias = diag_antialias
blockdiag_transparency = diag_transparency
blockdiag_html_image_format = diag_html_image_format
blockdiag_fontpath = diag_fontpath
blockdiag_latex_image_format = diag_latex_image_format
blockdiag_debug = diag_debug

nwdiag_antialias = diag_antialias
nwdiag_transparency = diag_transparency
nwdiag_html_image_format = diag_html_image_format
nwdiag_latex_image_format = diag_latex_image_format
nwdiag_fontpath = diag_fontpath
nwdiag_debug = diag_debug

seqdiag_antialias = diag_antialias
seqdiag_transparency = diag_transparency
seqdiag_html_image_format = diag_html_image_format
seqdiag_latex_image_format = diag_latex_image_format
seqdiag_fontpath = diag_fontpath
seqdiag_debug = diag_debug


if use_bibtex:
    bibtex_bibfiles = ['refs.bib']
    import pybtex.style.formatting
    from pybtex.richtext import Text, Tag

    class NervPybtexStyle(pybtex.style.formatting.BaseStyle):
        def format_article(self, entry):
            return Text(Tag('em', entry.fields['key']))