crieur 2.0.2__py3-none-any.whl

crieur/templates/numeros.html

@@ -0,0 +1,24 @@
+{% extends "base.html" %}
+
+{% block content %}
+  {% for numero in numeros|reverse %}
+    <div class="aside">
+      <hgroup>
+        <h2><a href="{{ base_url }}numero/{{ numero.slug }}/">{{ numero.title_f }}</a></h2>
+        <p class="muted"><small>{{ numero.date.strftime('%d %B %Y') }}</small></p>
+      </hgroup>
+      <ul>
+        {% for article in numero.articles %}
+          <li>
+            <a href="{{ base_url }}{{ article.url }}">{{ article.title_f }}</a>
+            par
+            {% for author in article.authors -%}
+              <em>{{ author.forname }} {{ author.surname }}{%- if not loop.last -%}, {% endif %}</em>
+            {%- endfor %}
+            <nobr><span class="muted"><small>({{ article.date.strftime('%d %B %Y') }})</small></span></nobr>
+          </li>
+        {% endfor %}
+      </ul>
+    </div>
+  {% endfor %}
+{% endblock content %}

crieur/typography.py

@@ -0,0 +1,93 @@
+import html.entities
+import unicodedata
+from dataclasses import dataclass
+
+import regex  # pour le support de "\p{}"
+
+
+@dataclass
+class Caractere:
+    unicode: str
+    html: str
+
+    def __init__(self, name: str):
+        self.unicode = unicodedata.lookup(name)
+        codepoint = ord(self.unicode)
+        html_name = html.entities.codepoint2name.get(codepoint, f"#{codepoint}")
+        self.html = f"&{html_name};"
+
+
+ESPACE_INSECABLE = Caractere(name="NO-BREAK SPACE")
+ESPACE_FINE_INSECABLE = Caractere(name="NARROW NO-BREAK SPACE")
+
+
+def assemble_regexes(*regexes):
+    return "|".join(regexes)
+
+
+def build_regex(avant, apres):
+    # \p{} permet de reconnaître un caractère par sa catégorie Unicode
+    # "Zs" est la catégorie "Separator, space".
+    return (
+        rf"((?P<avant>{avant})"
+        + rf"(\p{{Zs}}|{ESPACE_INSECABLE.html})"
+        + rf"(?P<apres>{apres}))"
+        + r"(?!(.(?!<svg))*<\/svg>)"
+    )
+
+
+RE_ESPACE_FINE_INSECABLE = regex.compile(
+    assemble_regexes(
+        build_regex(r"\w?", r"[;\?!]"),  # Ponctuations doubles.
+        build_regex(
+            r"\d", r"([ghj]|min|sec|images|mm|hab|kg|mg|µg|L|km|°C|GHz)(\b|$)"
+        ),  # Unités.
+        build_regex(r"\d", r"(Mo|Ko|Go|Mb|Kb|Gb)(\b|$)"),  # Tailles de fichiers.
+        build_regex(r"\d", r"%"),  # Pourcentages.
+        build_regex(r"\d", r"€"),  # Symboles monétaires.
+        build_regex(r"\d", r"\d"),  # Séparateurs de milliers.
+    )
+)
+
+
+def insere_espaces_fines_insecables(texte):
+    return RE_ESPACE_FINE_INSECABLE.sub(
+        r"\g<avant>" + ESPACE_FINE_INSECABLE.unicode + r"\g<apres>", texte
+    )
+
+
+RE_ESPACE_INSECABLE = regex.compile(
+    assemble_regexes(
+        build_regex(r"\w?", r":"),  # Deux points.
+        build_regex(r"«", r""),  # Guillemets en chevrons.
+        build_regex(r"", r"»"),  # Guillemets en chevrons.
+        build_regex(
+            rf"\b(\d|{ESPACE_FINE_INSECABLE.html})+", r"(?!\d)\w"
+        ),  # Nombre suivi de lettres.
+        build_regex(r"(M\.|Mme)", r"\w"),  # Titres (Monsieur, Madame).
+    )
+)
+
+
+def insere_espaces_insecables(texte):
+    return RE_ESPACE_INSECABLE.sub(
+        r"\g<avant>" + ESPACE_INSECABLE.unicode + r"\g<apres>", texte
+    )
+
+
+def encode_espaces_insecables_en_html(texte):
+    for caractere in (ESPACE_INSECABLE, ESPACE_FINE_INSECABLE):
+        texte = texte.replace(caractere.unicode, caractere.html)
+    return texte
+
+
+def typographie(texte, html=False):
+    """
+    Utilise les espaces insécables fines ou normales lorsque c’est approprié
+
+    https://fr.wikipedia.org/wiki/Espace_ins%C3%A9cable#En_France
+    """
+    res = insere_espaces_fines_insecables(insere_espaces_insecables(texte))
+    if html:
+        res = encode_espaces_insecables_en_html(res)
+    return res

crieur/utils.py

@@ -0,0 +1,56 @@
+import re
+from pathlib import Path
+
+html_comments_re = re.compile(r"<!--.*?-->")
+html_tags_re = re.compile(r"<[^>]*>")
+
+
+def strip_html_comments(value):
+    if not value:
+        return ""
+    return html_comments_re.sub("", value)
+
+
+def strip_html_tags(value):
+    if not value:
+        return ""
+    return html_tags_re.sub("", value)
+
+
+def each_file_from(source_dir, pattern="*.html", exclude=None):
+    """Walk across the `source_dir` and return the html file paths."""
+    for path in _each_path_from(source_dir, pattern=pattern, exclude=exclude):
+        if path.is_file():
+            yield path
+
+
+def each_folder_from(source_dir, exclude=None):
+    """Walk across the `source_dir` and return the folder paths."""
+    for path in _each_path_from(source_dir, exclude=exclude):
+        if path.is_dir():
+            yield path
+
+
+def _each_path_from(source_dir, pattern="*", exclude=None):
+    for path in sorted(Path(source_dir).glob(pattern)):
+        if exclude is not None and path.name in exclude:
+            continue
+        yield path
+
+
+def neighborhood(iterable, first=None, last=None):
+    """
+    Yield the (index, previous, current, next) items given an iterable.
+
+    You can specify a `first` and/or `last` item for bounds.
+    """
+    index = 1
+    iterator = iter(iterable)
+    previous = first
+    current = next(iterator)  # Throws StopIteration if empty.
+    for next_ in iterator:
+        yield (index, previous, current, next_)
+        previous = current
+        index += 1
+        current = next_
+    yield (index, previous, current, last)