Register Guidelines E-Books Today's Posts Search

Go Back   MobileRead Forums > E-Book Software > Sigil

Notices

Reply
 
Thread Tools Search this Thread
Old 06-21-2025, 10:12 AM   #31
philja
Addict
philja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enough
 
Posts: 262
Karma: 516
Join Date: Nov 2015
Location: Europe EEC
Device: Kindle Fire HD6 & HD8
Quote:
Originally Posted by Doitsu View Post
If you're using my EpubCheck plugin, it should briefly display the EPUBCheck version number like this:
Code:
Running EPUBCheck 5.2.1... please wait.
Maybe the update code failed to download to the latest version.


Are you sure that you didn't select a different validator? AFAIK, my EpubCheck plugin doesn't display blue error messages. Also, IIRC, EPUBCheck doesn't check epub:type values.
When running your plugin, all my machines show that message - so all are running 5.2.1. In fact, the W10 box hadn't run for a while so I saw the update check run before 5.2.1.

I only get the 'blue' message on my linux box running UbuntuStudio24.04.1 and with the Beta2 Sigil.

Years ago when I first started using Sigil (v0.9ish), I used to get lots of messages from the epubcheck plugin. The first few were in blue and the others in red. IIRC, someone on this forum said the blues were for info only and could be ignored and only the red needed fixing to validate the epub.

These days, it's rare to get any message at all so I've probably upped my game a bit. On a new epub3 generated from scratch in Sigil Beta2, filled with some 'lorem ipsum' text and a footnote with backlink using the new Aria Clips, I still get that message on the linux box, but not on W10 nor MacBook.

And I'm certain I only used your plugin to validate and there's no coding error. I don't understand why it's only the linux box which produces this message, but I'm not going to worry too much about it.
Attached Thumbnails
Click image for larger version

Name:	Screenshot_20250621_160627.png
Views:	13
Size:	199.2 KB
ID:	216390  
philja is offline   Reply With Quote
Old 06-21-2025, 12:40 PM   #32
Doitsu
Grand Sorcerer
Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.
 
Doitsu's Avatar
 
Posts: 5,723
Karma: 24031401
Join Date: Dec 2010
Device: Kindle PW2
Quote:
Originally Posted by philja View Post
And I'm certain I only used your plugin to validate and there's no coding error. I don't understand why it's only the linux box which produces this message, but I'm not going to worry too much about it.
This is an INFO message that is shown, because you've enabled the Usage option in EpubCheck.json via:

Code:
  "usage": true,
Apparently, the EPUBCheck devs decided way back in 2019 to report all epub:type value checks as USAGE messages and it doesn't look like that they've updated the usage checker code in a while...
Doitsu is offline   Reply With Quote
Advert
Old 06-21-2025, 12:40 PM   #33
DiapDealer
Grand Sorcerer
DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.
 
DiapDealer's Avatar
 
Posts: 28,525
Karma: 204127028
Join Date: Jan 2010
Device: Nexus 7, Kindle Fire HD
I'm not getting the "Unrecognized epub:type value 'backlink'" warning on Linux with the Beta 2 AppImage. New Epub3; ipsum lorem text; made a footnote with backlink using the Aria Clips.

Using version 0.4.7.1 of the EpubCheck plugin (with version 5.2.1 of Epubcheck).
DiapDealer is online now   Reply With Quote
Old 06-21-2025, 01:01 PM   #34
DiapDealer
Grand Sorcerer
DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.
 
DiapDealer's Avatar
 
Posts: 28,525
Karma: 204127028
Join Date: Jan 2010
Device: Nexus 7, Kindle Fire HD
Quote:
Originally Posted by Doitsu View Post
This is an INFO message that is shown, because you've enabled the Usage option in EpubCheck.json via:

Code:
  "usage": true,
Apparently, the EPUBCheck devs decided way back in 2019 to report all epub:type value checks as USAGE messages and it doesn't look like that they've updated the usage checker code in a while...
Well that explains it.
DiapDealer is online now   Reply With Quote
Old 06-21-2025, 01:03 PM   #35
Doitsu
Grand Sorcerer
Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.
 
Doitsu's Avatar
 
Posts: 5,723
Karma: 24031401
Join Date: Dec 2010
Device: Kindle PW2
Quote:
Originally Posted by DiapDealer View Post
I'm not getting the "Unrecognized epub:type value 'backlink'" warning on Linux with the Beta 2 AppImage. New Epub3; ipsum lorem text; made a footnote with backlink using the Aria Clips.

Using version 0.4.7.1 of the EpubCheck plugin (with version 5.2.1 of Epubcheck).
If you're using my Sigil plugin, you'll need to add/edit this line in EpubCheck.json.

Code:
  "usage": true,
Or if you're using the command line:

Code:
java -jar "C:\Users\user\AppData\Local\sigil-ebook\sigil\plugins\EpubCheck\epubcheck.jar" "C:\Users\user\Downloads\backlink.epub" -u --json -
The output will be:


Spoiler:
Code:
No errors or warnings detected.
{
  "messages" : [ {
    "ID" : "OPF-088",
    "severity" : "USAGE",
    "message" : "Unrecognized epub:type value \"backlink\".",
    "additionalLocations" : 0,
    "locations" : [ {
      "url" : {
        "opaque" : false,
        "hierarchical" : true
      },
      "path" : "OEBPS/Text/Section0001.xhtml",
      "line" : 12,
      "column" : 116,
      "context" : null
    } ],
    "suggestion" : null
  } ],
  "customMessageFileName" : null,
  "checker" : {
    "path" : ".\\Downloads\\backlink.epub",
    "filename" : "backlink.epub",
    "checkerVersion" : "5.2.1",
    "checkDate" : "06-21-2025 18:57:32",
    "elapsedTime" : 32994,
    "nFatal" : 0,
    "nError" : 0,
    "nWarning" : 0,
    "nUsage" : 1
  },
  "publication" : {
    "publisher" : null,
    "title" : "backlink test",
    "creator" : [ ],
    "date" : "2025-06-21T18:54:55Z",
    "subject" : [ ],
    "description" : null,
    "rights" : null,
    "identifier" : "urn:uuid:15d02007-6607-431f-be22-581de695ebdf",
    "language" : "en",
    "nSpines" : 2,
    "checkSum" : 0,
    "renditionLayout" : "reflowable",
    "renditionOrientation" : "auto",
    "renditionSpread" : "auto",
    "ePubVersion" : "3.3",
    "isScripted" : false,
    "hasFixedFormat" : false,
    "isBackwardCompatible" : false,
    "hasAudio" : false,
    "hasVideo" : false,
    "charsCount" : 218,
    "embeddedFonts" : [ ],
    "refFonts" : [ ],
    "hasEncryption" : false,
    "hasSignatures" : false,
    "contributors" : [ ]
  },
  "items" : [ {
    "id" : "Section0001.xhtml",
    "fileName" : "OEBPS/Text/Section0001.xhtml",
    "media_type" : "application/xhtml+xml",
    "compressedSize" : 280,
    "uncompressedSize" : 456,
    "compressionMethod" : "Deflated",
    "checkSum" : "bb2932f84166f7ae12b1c71e4918fbf18996d1aadbad4dc943bcfd71bee634",
    "isSpineItem" : true,
    "spineIndex" : 0,
    "isLinear" : true,
    "isFixedFormat" : false,
    "isScripted" : false,
    "renditionLayout" : "reflowable",
    "renditionOrientation" : "auto",
    "renditionSpread" : "auto",
    "referencedItems" : [ "OEBPS/Text/Section0001.xhtml#en1" ]
  }, {
    "id" : "ePubCheck.NoManifestRef:META-INF/container.xml",
    "fileName" : "META-INF/container.xml",
    "media_type" : null,
    "compressedSize" : 180,
    "uncompressedSize" : 265,
    "compressionMethod" : "Deflated",
    "checkSum" : "83e412f1ac7d52a9f73d82d26c9ce241591c60b8e9c384956e9e588e1d5fc",
    "isSpineItem" : false,
    "spineIndex" : null,
    "isLinear" : false,
    "isFixedFormat" : null,
    "isScripted" : false,
    "renditionLayout" : null,
    "renditionOrientation" : null,
    "renditionSpread" : null,
    "referencedItems" : [ ]
  }, {
    "id" : "ePubCheck.NoManifestRef:OEBPS/content.opf",
    "fileName" : "OEBPS/content.opf",
    "media_type" : null,
    "compressedSize" : 428,
    "uncompressedSize" : 912,
    "compressionMethod" : "Deflated",
    "checkSum" : "afd0bacff9dda1cae13c6b2ba5952345adc4c26fbee84ef84236cd2d3e3ea8",
    "isSpineItem" : false,
    "spineIndex" : null,
    "isLinear" : false,
    "isFixedFormat" : null,
    "isScripted" : false,
    "renditionLayout" : null,
    "renditionOrientation" : null,
    "renditionSpread" : null,
    "referencedItems" : [ ]
  }, {
    "id" : "ePubCheck.NoManifestRef:mimetype",
    "fileName" : "mimetype",
    "media_type" : null,
    "compressedSize" : 20,
    "uncompressedSize" : 20,
    "compressionMethod" : "Stored",
    "checkSum" : "e468e350d1143eb648f6c7bbd63111ec544a361ca74ecef256ac91f48b",
    "isSpineItem" : false,
    "spineIndex" : null,
    "isLinear" : false,
    "isFixedFormat" : null,
    "isScripted" : false,
    "renditionLayout" : null,
    "renditionOrientation" : null,
    "renditionSpread" : null,
    "referencedItems" : [ ]
  }, {
    "id" : "nav.xhtml",
    "fileName" : "OEBPS/Text/nav.xhtml",
    "media_type" : "application/xhtml+xml",
    "compressedSize" : 368,
    "uncompressedSize" : 741,
    "compressionMethod" : "Deflated",
    "checkSum" : "c4e8b5e345a9ab3c2b6dc8fa54253309213d2fab9dbb322abcf4cfd441",
    "isSpineItem" : true,
    "spineIndex" : 1,
    "isLinear" : false,
    "isFixedFormat" : false,
    "isScripted" : false,
    "renditionLayout" : "reflowable",
    "renditionOrientation" : "auto",
    "renditionSpread" : "auto",
    "referencedItems" : [ "OEBPS/Styles/sgc-nav.css", "OEBPS/Text/Section0001.xhtml", "OEBPS/Text/nav.xhtml#toc" ]
  }, {
    "id" : "sgc-nav.css",
    "fileName" : "OEBPS/Styles/sgc-nav.css",
    "media_type" : "text/css",
    "compressedSize" : 151,
    "uncompressedSize" : 275,
    "compressionMethod" : "Deflated",
    "checkSum" : "d7bc6622fc698f2beeaeea31a6f4123de3d71536ca69c6673a1e28f2064c372",
    "isSpineItem" : false,
    "spineIndex" : null,
    "isLinear" : false,
    "isFixedFormat" : null,
    "isScripted" : false,
    "renditionLayout" : null,
    "renditionOrientation" : null,
    "renditionSpread" : null,
    "referencedItems" : [ ]
  } ]
}
Attached Files
File Type: epub backlink.epub (2.1 KB, 3 views)
Doitsu is offline   Reply With Quote
Advert
Old 06-21-2025, 01:32 PM   #36
KevinH
Sigil Developer
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 8,704
Karma: 5703586
Join Date: Nov 2009
Device: many
Quote:
Originally Posted by Doitsu View Post
If you're using my Sigil plugin, you'll need to add/edit this line in EpubCheck.json.

Code:
  "usage": true,
Or if you're using the command line:

Code:
java -jar "C:\Users\user\AppData\Local\sigil-ebook\sigil\plugins\EpubCheck\epubcheck.jar" "C:\Users\user\Downloads\backlink.epub" -u --json -
The output will be:


Spoiler:
Code:
No errors or warnings detected.
{
  "messages" : [ {
    "ID" : "OPF-088",
    "severity" : "USAGE",
    "message" : "Unrecognized epub:type value \"backlink\".",
    "additionalLocations" : 0,
    "locations" : [ {
      "url" : {
        "opaque" : false,
        "hierarchical" : true
      },
      "path" : "OEBPS/Text/Section0001.xhtml",
      "line" : 12,
      "column" : 116,
      "context" : null
    } ],
    "suggestion" : null
  } ],
  "customMessageFileName" : null,
  "checker" : {
    "path" : ".\\Downloads\\backlink.epub",
    "filename" : "backlink.epub",
    "checkerVersion" : "5.2.1",
    "checkDate" : "06-21-2025 18:57:32",
    "elapsedTime" : 32994,
    "nFatal" : 0,
    "nError" : 0,
    "nWarning" : 0,
    "nUsage" : 1
  },
  "publication" : {
    "publisher" : null,
    "title" : "backlink test",
    "creator" : [ ],
    "date" : "2025-06-21T18:54:55Z",
    "subject" : [ ],
    "description" : null,
    "rights" : null,
    "identifier" : "urn:uuid:15d02007-6607-431f-be22-581de695ebdf",
    "language" : "en",
    "nSpines" : 2,
    "checkSum" : 0,
    "renditionLayout" : "reflowable",
    "renditionOrientation" : "auto",
    "renditionSpread" : "auto",
    "ePubVersion" : "3.3",
    "isScripted" : false,
    "hasFixedFormat" : false,
    "isBackwardCompatible" : false,
    "hasAudio" : false,
    "hasVideo" : false,
    "charsCount" : 218,
    "embeddedFonts" : [ ],
    "refFonts" : [ ],
    "hasEncryption" : false,
    "hasSignatures" : false,
    "contributors" : [ ]
  },
  "items" : [ {
    "id" : "Section0001.xhtml",
    "fileName" : "OEBPS/Text/Section0001.xhtml",
    "media_type" : "application/xhtml+xml",
    "compressedSize" : 280,
    "uncompressedSize" : 456,
    "compressionMethod" : "Deflated",
    "checkSum" : "bb2932f84166f7ae12b1c71e4918fbf18996d1aadbad4dc943bcfd71bee634",
    "isSpineItem" : true,
    "spineIndex" : 0,
    "isLinear" : true,
    "isFixedFormat" : false,
    "isScripted" : false,
    "renditionLayout" : "reflowable",
    "renditionOrientation" : "auto",
    "renditionSpread" : "auto",
    "referencedItems" : [ "OEBPS/Text/Section0001.xhtml#en1" ]
  }, {
    "id" : "ePubCheck.NoManifestRef:META-INF/container.xml",
    "fileName" : "META-INF/container.xml",
    "media_type" : null,
    "compressedSize" : 180,
    "uncompressedSize" : 265,
    "compressionMethod" : "Deflated",
    "checkSum" : "83e412f1ac7d52a9f73d82d26c9ce241591c60b8e9c384956e9e588e1d5fc",
    "isSpineItem" : false,
    "spineIndex" : null,
    "isLinear" : false,
    "isFixedFormat" : null,
    "isScripted" : false,
    "renditionLayout" : null,
    "renditionOrientation" : null,
    "renditionSpread" : null,
    "referencedItems" : [ ]
  }, {
    "id" : "ePubCheck.NoManifestRef:OEBPS/content.opf",
    "fileName" : "OEBPS/content.opf",
    "media_type" : null,
    "compressedSize" : 428,
    "uncompressedSize" : 912,
    "compressionMethod" : "Deflated",
    "checkSum" : "afd0bacff9dda1cae13c6b2ba5952345adc4c26fbee84ef84236cd2d3e3ea8",
    "isSpineItem" : false,
    "spineIndex" : null,
    "isLinear" : false,
    "isFixedFormat" : null,
    "isScripted" : false,
    "renditionLayout" : null,
    "renditionOrientation" : null,
    "renditionSpread" : null,
    "referencedItems" : [ ]
  }, {
    "id" : "ePubCheck.NoManifestRef:mimetype",
    "fileName" : "mimetype",
    "media_type" : null,
    "compressedSize" : 20,
    "uncompressedSize" : 20,
    "compressionMethod" : "Stored",
    "checkSum" : "e468e350d1143eb648f6c7bbd63111ec544a361ca74ecef256ac91f48b",
    "isSpineItem" : false,
    "spineIndex" : null,
    "isLinear" : false,
    "isFixedFormat" : null,
    "isScripted" : false,
    "renditionLayout" : null,
    "renditionOrientation" : null,
    "renditionSpread" : null,
    "referencedItems" : [ ]
  }, {
    "id" : "nav.xhtml",
    "fileName" : "OEBPS/Text/nav.xhtml",
    "media_type" : "application/xhtml+xml",
    "compressedSize" : 368,
    "uncompressedSize" : 741,
    "compressionMethod" : "Deflated",
    "checkSum" : "c4e8b5e345a9ab3c2b6dc8fa54253309213d2fab9dbb322abcf4cfd441",
    "isSpineItem" : true,
    "spineIndex" : 1,
    "isLinear" : false,
    "isFixedFormat" : false,
    "isScripted" : false,
    "renditionLayout" : "reflowable",
    "renditionOrientation" : "auto",
    "renditionSpread" : "auto",
    "referencedItems" : [ "OEBPS/Styles/sgc-nav.css", "OEBPS/Text/Section0001.xhtml", "OEBPS/Text/nav.xhtml#toc" ]
  }, {
    "id" : "sgc-nav.css",
    "fileName" : "OEBPS/Styles/sgc-nav.css",
    "media_type" : "text/css",
    "compressedSize" : 151,
    "uncompressedSize" : 275,
    "compressionMethod" : "Deflated",
    "checkSum" : "d7bc6622fc698f2beeaeea31a6f4123de3d71536ca69c6673a1e28f2064c372",
    "isSpineItem" : false,
    "spineIndex" : null,
    "isLinear" : false,
    "isFixedFormat" : null,
    "isScripted" : false,
    "renditionLayout" : null,
    "renditionOrientation" : null,
    "renditionSpread" : null,
    "referencedItems" : [ ]
  } ]
}
We should file an official bug report with epubcheck to update its epub3 structural semantics vocabulary to the very latest 1.1 standard just released in March.

Does the info also barf when epub:type="backlink" is replaced by much older epub:type="referrer"?
KevinH is offline   Reply With Quote
Old 06-21-2025, 01:58 PM   #37
Doitsu
Grand Sorcerer
Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.
 
Doitsu's Avatar
 
Posts: 5,723
Karma: 24031401
Join Date: Dec 2010
Device: Kindle PW2
Quote:
Originally Posted by KevinH View Post
Does the info also barf when epub:type="backlink" is replaced by much older epub:type="referrer"?
No.

BTW, I checked the latest specs and backlink still has a draft status.
Doitsu is offline   Reply With Quote
Old 06-21-2025, 02:06 PM   #38
KevinH
Sigil Developer
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 8,704
Karma: 5703586
Join Date: Nov 2009
Device: many
Quote:
Originally Posted by Doitsu View Post
No.

BTW, I checked the latest specs and backlink still has a draft status.
But "referrer" is gone. It has not been on the list in years. It is not even just deprecated.

So to follow the spec we either need to drop support for both epub:type="referrer" as it is no longer part of the official vocabulary (and has not been for years) or we replace it with the draft backlink but it has been draft for years.

Either way, the bug is in epubcheck.
KevinH is offline   Reply With Quote
Old 06-21-2025, 02:34 PM   #39
KevinH
Sigil Developer
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 8,704
Karma: 5703586
Join Date: Nov 2009
Device: many
I have opened the following issue in epubcheck explaining the situation. Hopefully they will modify a future version of epubcheck to do "the right thing" whatever that is.

My hope is the powers that be will formally adopt the draft "backlink" and epubcheck will support it properly or maybe return "referrer" to the standard vocabulary list.

One or the other should work.


https://github.com/w3c/epubcheck/issues/1617
KevinH is offline   Reply With Quote
Old 06-21-2025, 02:50 PM   #40
Doitsu
Grand Sorcerer
Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.Doitsu ought to be getting tired of karma fortunes by now.
 
Doitsu's Avatar
 
Posts: 5,723
Karma: 24031401
Join Date: Dec 2010
Device: Kindle PW2
Quote:
Originally Posted by KevinH View Post
I have opened the following issue in epubcheck explaining the situation. Hopefully they will modify a future version of epubcheck to do "the right thing" whatever that is.
FYI: when you run EPUCheck with the optional -u/--usage parameter, it'll output the following message:

USAGE(OPF-088): C:/Users/user/Downloads/backlink.epub/OEBPS/Text/Section0001.xhtml(12,116): Unrecognized epub:type value "backlink".

In JSON mode, it'll be:

Code:
  "messages" : [ {
    "ID" : "OPF-088",
    "severity" : "USAGE",
    "message" : "Unrecognized epub:type value \"backlink\".",
    "additionalLocations" : 0,
    "locations" : [ {
      "url" : {
        "opaque" : false,
        "hierarchical" : true
      }
(Since it's neither a warning nor an error I mapped it to an INFO message in Sigil.)

If you hear back from the EPUBCheck devs, they'll probably want to know the message code, which is "OPF-088."

Since this message, which is neither a warning nor an error, is only shown if the optional -u/--usage parameter is specified hardly anybody will ever see it anyway.

EDIT: I've just found this 2016(!) post:

Quote:
Originally Posted by Matt Garrish
There was a draft property named referrer, but was changed to backlink during the process of creating the DPUB-ARIA vocabulary.

The change has to be made to the edupub spec, too, but as that work is on hiatus at the moment we haven't had an opportunity to do it.

Epubcheck won't validate backlink until it gets updated to reflect the changes made during the 3.1 revision. It is the correct term to be using moving forward, though.
(Emphasis mine)

Last edited by Doitsu; 06-21-2025 at 03:08 PM.
Doitsu is offline   Reply With Quote
Old 06-21-2025, 04:07 PM   #41
KevinH
Sigil Developer
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 8,704
Karma: 5703586
Join Date: Nov 2009
Device: many
Hi All,

I took a shot at making Aria Clips be a bit smarted about the _N_ and with \\1.

Now if I want a footnote div with _N_ being 3 and I was marking up existing text I could do the following, assume this is my existing text (or that I added it by hand)

Code:
[3] The text of my footnote goes here.
Then highlight that footnote including its leading number in CV and Insert a Aria Clip with footnote div.

It should now produce the following:

Code:
<div id="fn3" epub:type="footnote" role="doc-footnote">
  <p>
    <a href="#ref_fn3" epub:type="backlink" role="doc-backlink">[3]</a>
    This is the text of my footnote.
  </p>
</div>
Hopefully this will help speed things up when handling markup of existing text.

It works similarly for footnote with aside, footnote with div, and endnote in li.

It also works just on the _N_ field in footnote ref, footnote backlink, endnote ref, endnote_backlink, and pagebreak_span

I am still working on positioning the cursor into the empty section and aside tags. I have not figured out a way to do that easily (yet).

I have pushed all of this to Sigil master with deploy and will post new Beta-3 builds shortly.
KevinH is offline   Reply With Quote
Old 06-21-2025, 04:16 PM   #42
KevinH
Sigil Developer
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 8,704
Karma: 5703586
Join Date: Nov 2009
Device: many
Hi Doitsu,

Wonderful. I have liberally copied and pasted this extra information into my issue on epubcheck, with the hope it clarifies things. They should simply remove that check or accept backlink.

Thanks,


Quote:
Originally Posted by Doitsu View Post
FYI: when you run EPUCheck with the optional -u/--usage parameter, it'll output the following message:

USAGE(OPF-088): C:/Users/user/Downloads/backlink.epub/OEBPS/Text/Section0001.xhtml(12,116): Unrecognized epub:type value "backlink".

In JSON mode, it'll be:

Code:
  "messages" : [ {
    "ID" : "OPF-088",
    "severity" : "USAGE",
    "message" : "Unrecognized epub:type value \"backlink\".",
    "additionalLocations" : 0,
    "locations" : [ {
      "url" : {
        "opaque" : false,
        "hierarchical" : true
      }
(Since it's neither a warning nor an error I mapped it to an INFO message in Sigil.)

If you hear back from the EPUBCheck devs, they'll probably want to know the message code, which is "OPF-088."

Since this message, which is neither a warning nor an error, is only shown if the optional -u/--usage parameter is specified hardly anybody will ever see it anyway.

EDIT: I've just found this 2016(!) post:



(Emphasis mine)
KevinH is offline   Reply With Quote
Old 06-21-2025, 04:36 PM   #43
KevinH
Sigil Developer
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 8,704
Karma: 5703586
Join Date: Nov 2009
Device: many
Okay I have posted a Sigil 2.6.0 Beta-3 builds to play and test with. It should now support the "smarter" clips by gleaning number from text selected in CV.

They are all unsigned direct from our github CI builds.

There are available on the Releases page of one of my github repositories:

https://github.com/kevinhendricks/Bu...OnMac/releases

Of course, for anyone who builds their own, you can build from current official Sigil master.


All feedback welcome.

KevinH
KevinH is offline   Reply With Quote
Old 06-21-2025, 04:50 PM   #44
philja
Addict
philja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enough
 
Posts: 262
Karma: 516
Join Date: Nov 2015
Location: Europe EEC
Device: Kindle Fire HD6 & HD8
Quote:
Originally Posted by Doitsu View Post
This is an INFO message that is shown, because you've enabled the Usage option in EpubCheck.json via:

Code:
  "usage": true,
Apparently, the EPUBCheck devs decided way back in 2019 to report all epub:type value checks as USAGE messages and it doesn't look like that they've updated the usage checker code in a while...
Great ! You've cracked it and I've learnt that blue messages are info and not warnings.

I checked the EpubCheck.json file in my Linux box and you're right - "usage":true

I then went to my W10 box and found "usage": false. I set it to true and voila!, W10 also announces that epub:type value "backlink" is unrecognised.

Curiously, I have no recollection of ever having edited the EpubCheck.json file in any of my machines. But now I have, I've set "usage": false on all boxes.
philja is offline   Reply With Quote
Old 06-21-2025, 05:32 PM   #45
philja
Addict
philja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enoughphilja will become famous soon enough
 
Posts: 262
Karma: 516
Join Date: Nov 2015
Location: Europe EEC
Device: Kindle Fire HD6 & HD8
Beta 3 with the revised footnote clips works well on my linux box. All the ref no's and highlighted text were correctly placed.

When you have several footnotes at the end of a chapter, having each one wrapped in <div> tags makes for an ugly load of code. If the

Code:
 <div id="fn2" epub:type="footnote" role="doc-footnote">
could be placed in the <p> tag and a second lot of <div> tags eliminated, it would be much neater. For example,

Code:
<div>
  <p id="fn1" epub:type="footnote" role="doc-footnote">
    <a href="#ref_fn1" epub:type="backlink" role="doc-backlink">[1]</a>
    TEXT_OF_FOOTNOTE_HERE
  </p>
  <p id="fn2" epub:type="footnote" role="doc-footnote">
    <a href="#ref_fn2" epub:type="backlink" role="doc-backlink">[2]</a>
    for more info on this item, look at chapter 6
  </p>
</div>
I've tried it out with a couple of footnotes inside a single set of <div> tags and with the id's in the <p> tags and EpubCheck lets it pass ok.

Would that violate any rules?
philja is offline   Reply With Quote
Reply


Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Beta Testers for Sigil-2.3.0 Needed KevinH Sigil 71 07-22-2024 09:54 AM
Call for beta testers https://kobli.me neuraltoxin Kobo Developer's Corner 10 01-21-2023 12:43 AM
Another call for testers NiLuJe Kobo Developer's Corner 26 09-20-2019 11:25 AM
Call for testers kovidgoyal Calibre 289 09-19-2008 01:45 PM


All times are GMT -4. The time now is 05:48 AM.


MobileRead.com is a privately owned, operated and funded community.