Commit 2838732a authored by Kourser's avatar Kourser
Browse files

fix: quatre défauts que seule la lecture d'un vrai livre fait sortir

« Profileuse » téléchargé depuis le serveur Calibre et ouvert dans le
simulateur iPad. Tout le chemin tient — couverture, pagination, sommaire,
saut au chapitre, sélection, traduction, narration phrase par phrase,
position retrouvée à la réouverture. Ce qui n'allait pas :

La dernière ligne de chaque page était tranchée en deux. Le lecteur
portait `.ignoresSafeArea(edges: .bottom)`, donc la vue web passait sous
le pied de page et sous la barre de narration au lieu de se repaginer.
Une rotation complète ne la réparait pas : ce n'était pas un défaut de
pagination mais une marge de sécurité ignorée.

Le menu de sélection offrait « Traduire » deux fois, côte à côte : le
nôtre, et celui qu'`EditingAction.defaultActions` ajoute.

Le panneau de traduction écrivait le même message deux fois quand le
modèle était la cause de l'échec — une fois en orange, une fois en gris.

La description d'un livre arrivait criblée de `<br…` :
Calibre stocke du texte échappé plusieurs fois de suite, et une seule
passe de déséchappement n'en venait pas à bout. Les entités sont
décodées en boucle, bornée, avant de retirer les balises.

Six tests figent le déséchappement. Les trois autres correctifs sont
revérifiés à l'écran : plus de ligne coupée avec le pied de page et la
barre de narration affichés, un seul « Traduire », un seul message.

Co-Authored-By: default avatarClaude Opus 5 <noreply@anthropic.com>
parent ce9a5e59
Loading
Loading
Loading
Loading
+12 −0
Changes for CHANGELOG.md: 12 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -8,6 +8,18 @@ adopte le [versionnage sémantique](https://semver.org/lang/fr/).
## [Non publié]

### Corrigé
- La dernière ligne de la page était tranchée en deux. Le lecteur EPUB
  ignorait la marge de sécurité basse, donc la vue web passait sous le pied de
  page et sous la barre de narration au lieu de se repaginer. Visible sur un
  vrai livre, dans les deux orientations.
- Le menu de sélection proposait « Traduire » deux fois, le nôtre et celui du
  système : les actions par défaut de Readium ajoutaient le second.
- Le panneau de traduction affichait deux fois le même message quand le modèle
  était en cause — une fois en orange, une fois en gris.
- La description d'un livre arrivait criblée de `&amp;amp;amp;lt;br…`. Calibre
  stocke du texte échappé plusieurs fois de suite ; une seule passe de
  déséchappement n'en venait pas à bout. Les entités sont maintenant décodées
  en boucle, et les `<br>` deviennent des sauts de ligne.
- Le nom de la bibliothèque était encodé deux fois : « Bibliothèque_calibre »
  partait en `Biblioth%25C3%25A8que_calibre` et le serveur refusait toute
  requête nommant une bibliothèque. `/ajax/library-info`, qui n'en nomme
+8 −2
Changes for Packages/Core/Sources/PodbookUI/Reader/EPUBReader.swift: 8 added lines, 2 removed lines.
Original line number Diff line number Diff line
@@ -338,7 +338,11 @@ struct EPUBReaderView: View {
                onTap: { model.toggleChrome() },
                onNavigator: { model.attach($0, preferences: preferences.preferences) }
            )
            .ignoresSafeArea(edges: .bottom)
            // No `.ignoresSafeArea(edges: .bottom)` here, however tempting it
            // looks for a full-bleed page: the footer and the narration bar are
            // safe-area insets, and letting the web view run underneath them
            // does not re-paginate the column — it just slices the last line in
            // half. Seen on a real book, in both orientations.
            .task {
                guard EPUBTextSource.canNarrate(publication) else { return }
                let language = publication.metadata.language?.code.bcp47 ?? "en-US"
@@ -412,7 +416,9 @@ private struct EPUBNavigatorContainer: UIViewControllerRepresentable {
                title: "Traduire",
                action: #selector(EPUBHostController.translateSelection)
            ),
        ] + EditingAction.defaultActions
        // `.defaultActions` would add the system's own Translate, and the menu
        // then offered « Traduire » twice side by side — ours and Apple's.
        ] + [.copy, .share, .lookup]
        config.preferences = preferences.epubPreferences

        do {
+9 −1
Changes for Packages/Core/Sources/PodbookUI/Translation/TranslationPanel.swift: 9 added lines, 1 removed line.
Original line number Diff line number Diff line
@@ -102,12 +102,20 @@ struct TranslationPanel: View {

    @ViewBuilder
    private var status: some View {
        if translator.modelStatus != .installed {
        // When the model *is* the reason the translation failed, the failure
        // above already says so. Printing the same sentence twice, once in
        // orange and once in grey, reads like a bug.
        if translator.modelStatus != .installed, !statusRepeatsFailure {
            Text(translator.modelStatus.label)
                .font(.footnote)
                .foregroundStyle(.secondary)
        }
    }

    private var statusRepeatsFailure: Bool {
        guard case .failed(_, let message) = translator.phase else { return false }
        return message == translator.modelStatus.label
    }
}

/// The saved words, and the way out to Anki.
+32 −4
Changes for Packages/Core/Sources/PodbookUI/Views/BookDetailView.swift: 32 added lines, 4 removed lines.
Original line number Diff line number Diff line
@@ -207,15 +207,43 @@ public struct BookDetailView: View {

extension String {
    /// Calibre's `comments` field is HTML. We only need the prose.
    ///
    /// The entities are decoded in a loop, because Calibre stores text that has
    /// been escaped several times over: one description arrived as
    /// `&amp;amp;amp;amp;amp;lt;br&amp;amp;amp;amp;amp;gt;`, which a single pass
    /// turns into `&amp;amp;amp;amp;lt;br…` — still unreadable. The loop is
    /// capped so a crafted string cannot spin here, and the tags are stripped
    /// only at the end, once there is nothing left to unescape.
    var strippingHTML: String {
        replacingOccurrences(of: "<[^>]+>", with: "", options: .regularExpression)
            .replacingOccurrences(of: "&nbsp;", with: " ")
            .replacingOccurrences(of: "&amp;", with: "&")
        var text = self
        for _ in 0 ..< 6 {
            let decoded = text.decodingHTMLEntitiesOnce
            if decoded == text { break }
            text = decoded
        }
        return text
            .replacingOccurrences(
                of: "<br[^>]*>", with: "\n",
                options: [.regularExpression, .caseInsensitive]
            )
            .replacingOccurrences(
                of: "</p[^>]*>", with: "\n\n",
                options: [.regularExpression, .caseInsensitive]
            )
            .replacingOccurrences(of: "<[^>]+>", with: "", options: .regularExpression)
            .replacingOccurrences(of: "\n{3,}", with: "\n\n", options: .regularExpression)
            .trimmingCharacters(in: .whitespacesAndNewlines)
    }

    /// `&amp;` goes last: otherwise `&amp;lt;` would lose its ampersand before
    /// the next round has a chance to read `&lt;` as one entity.
    private var decodingHTMLEntitiesOnce: String {
        replacingOccurrences(of: "&nbsp;", with: " ")
            .replacingOccurrences(of: "&lt;", with: "<")
            .replacingOccurrences(of: "&gt;", with: ">")
            .replacingOccurrences(of: "&#39;", with: "'")
            .replacingOccurrences(of: "&quot;", with: "\"")
            .trimmingCharacters(in: .whitespacesAndNewlines)
            .replacingOccurrences(of: "&amp;", with: "&")
    }
}

+47 −0
Changes for Packages/Core/Tests/PodbookUITests/BookDescriptionTests.swift: 47 added lines, 0 removed lines.
Original line number Diff line number Diff line
import Testing
@testable import PodbookUI

@Suite("Description d'un livre Calibre")
struct BookDescriptionTests {
    @Test("Les balises disparaissent et les entités simples sont rendues")
    func plainHTML() {
        let html = "<p>Un corps &amp; une for&#234;t.</p>"
        #expect(html.strippingHTML == "Un corps & une for&#234;t.")
    }

    @Test("Une entité échappée plusieurs fois finit par être lue")
    func multiplyEscaped() {
        // Relevé tel quel sur « Profileuse » dans la bibliothèque : un <br>
        // réécrit cinq fois. Une seule passe laissait « &amp;amp;amp;lt;br… »
        // au milieu de la phrase.
        let html = "nationale.&amp;amp;amp;amp;amp;lt;br&amp;amp;amp;amp;amp;gt;Loin des séries."
        let text = html.strippingHTML
        #expect(text.contains("&") == false, "plus rien à déséchapper")
        #expect(text.contains("br") == false, "le <br> doit devenir un saut de ligne")
        #expect(text == "nationale.\nLoin des séries.")
    }

    @Test("Les sauts de paragraphe sont gardés, mais pas empilés")
    func paragraphBreaks() {
        let html = "<p>Premier.</p><p>Deuxième.</p>"
        #expect(html.strippingHTML == "Premier.\n\nDeuxième.")
    }

    @Test("Une esperluette seule reste une esperluette")
    func loneAmpersand() {
        #expect("Dupont &amp; fils".strippingHTML == "Dupont & fils")
    }

    @Test("Du texte sans balise ressort intact")
    func plainText() {
        #expect("Rien à signaler.".strippingHTML == "Rien à signaler.")
    }

    @Test("Une chaîne construite pour boucler s'arrête quand même")
    func boundedLoop() {
        // « &amp;amp;amp;… » répété bien au-delà de ce qu'on déséchappe : le
        // résultat importe peu, ne pas y rester importe.
        let html = String(repeating: "&amp;", count: 200) + "lt;b&gt;"
        _ = html.strippingHTML
    }
}
Loading