Sigil-0.9.5 Released

[exaltedwombat]

Can't hurt! The inline TOC will get tagged automatically anyway.

[theducks]

Originally Posted by exaltedwombat

Can't hurt! The inline TOC will get tagged automatically anyway.

It only takes a few clicks
OP
doing that assume file per type. Set Semantics can NOT set more than one on any single file (nor the flip). Only ONE

[BetterRed]

Semantic tags are useful if the file names are meaningless - eg file001.html.

Suggestion - if a file has a Semantic tag then maybe it could be shown in Tools->Reports->Files

BR

[exaltedwombat]

Originally Posted by BetterRed

Semantic tags are useful if the file names are meaningless - eg file001.html.

Well, yes... But there are only a limited selection of preset semantic names. By the time you'd created appropriate ones and edited them in (can you? I suppose so) wouldn't it have been more sensible just to rename the files.

There's an excellent automatic system to name a string of files "Chapter_01", "Chapter_02" etc. - just select them all and rename the top one.

[BetterRed]

I was mainly thinking of front and back matter - renaming files to HalfTitle, Acknowledgements, Preface, Colophon, Foreword, References, Notes, Maps etc etc is tedious - easier to give them a Semantic tag

'Cept there's no Semantic tags for Maps and HalfTitle

BR

[bookman156]

Originally Posted by exaltedwombat

"Text" can affect which page is displayed when the file is first opened. It isn't universally recognized, but you might as well try!

So 'Text' can end up over-riding the cover in regards to where the EPUB opens to? Is that good? I think I'd feel the file was a bit 'pre-used' if it didn't open right at the start. So if I definitely want the EPUB to open on the cover does that mean I shouldn't use the 'Text' tag?

Do these semantic tags also get used in any Kindle book that may be made from the EPUB?

[Turtle91]

I put it in there whenever I clean up a book. I figure it only takes a few seconds...and IF future readers use it it will already be there. I also change file names as mentioned above.

[KevinH]

Epub3 does allow a much longer list of semantic types than epub2. That said, if you read the epub2 (2.0.1) spec for guide semantics they give the list we have plus add the fact that you can create your own types for those not listed by prefixing the semantic with the string "other.".

Notice the period. So epubcheck should certainly allow things like "other.halftitle" and "other.maps" as valid entries in the guide for epub2 as it is clearly allowed in the spec. I know of no readers that use those values but I could easily extend the epub2 add semantics dialog to include and use these "other." prefixed types if anyone is interested in using them for epub2.

epub3 already has a much longer list of allowed Semantic types for use in nav landmarks.


See http://www.idpf.org/epub/20/spec/OPF...htm#Section2.6

KevinH

Originally Posted by BetterRed

I was mainly thinking of front and back matter - renaming files to HalfTitle, Acknowledgements, Preface, Colophon, Foreword, References, Notes, Maps etc etc is tedious - easier to give them a Semantic tag

'Cept there's no Semantic tags for Maps and HalfTitle

BR

[BetterRed]

Originally Posted by KevinH

Epub3 does allow a much longer list of semantic types than epub2. That said, if you read the epub2 (2.0.1) spec for guide semantics they give the list we have plus add the fact that you can create your own types for those not listed by prefixing the semantic with the string "other.".

...

Whether or not to cater for other.semantic types etc is up to you Kevin.

I stand by my original suggestion - include the Semantic Tag assigned to a file in the Files Report.

BR

[Doitsu]

Originally Posted by bookman156

So 'Text' can end up over-riding the cover in regards to where the EPUB opens to? [...]
Do these semantic tags also get used in any Kindle book that may be made from the EPUB?

AFAIK, KindleGen is the only app that actually uses the Text or bodymatter semantics.

Originally Posted by BetterRed

I stand by my original suggestion - include the Semantic Tag assigned to a file in the Files Report.

IMHO, that would be overkill. You can quickly see all assigned semantics by looking at the guide section in the .opf file of ePub2 books or the landmarks section of the .nav file of ePub3 books.

[BetterRed]

Originally Posted by Doitsu

IMHO, that would be overkill. You can quickly see all assigned semantics by looking at the guide section in the .opf file of ePub2 books or the landmarks section of the .nav file of ePub3 books.

I avoid opening the .opf file unless there's a problem with it.

Having it in the Files Reports would tell me which files don't have a Semantic Type (ST).

But, something I hadn't realised until now is that any one ST can only be applied to one file - I knew a file couldn't have a multiple STs, but didn't appreciate reverse was true -- i.e the relationship must to be 1:1.

That means I can't have a book with 4 files marked Notes or 3 marked Index. It explains my - "I'm sure I marked that file as Notes" - puzzlements

I've been interpreting the word 'semantic' according to its common/normal/classical adjectival meaning; that it's sometimes used in this context as a noun <cringe, sigh> should have warned me.

The wombat has the measure of it - rename the files

"Semantics created some of us, and Syntaxes the rest of us" - BetterRed's Better Half in a Balmain pub - circa 1986

BR

[Doitsu]

Originally Posted by BetterRed

I avoid opening the .opf file unless there's a problem with it.

In general this is an good idea, however, as long as you don't change anything it's perfectly safe to open content.opf.

Originally Posted by BetterRed

But, something I hadn't realised until now is that any one ST can only be applied to one file - I knew a file couldn't have a multiple STs, but didn't appreciate reverse was true -- i.e the relationship must to be 1:1.

That's what I thought, too, because Sigl won't let you assign the same semantics type to multiple files in ePub2 books, but in ePub3 books you can actually assign the same semantics type to multiple files. For example, you can assign chapter to multiple .xhtml types.

[BetterRed]

Originally Posted by Doitsu

In general this is an good idea, however, as long as you don't change anything it's perfectly safe to open content.opf.

I don't thrust my 10 left thumbs.

Originally Posted by Doitsu

That's what I thought, too, because Sigl won't let you assign the same semantics type to multiple files in ePub2 books, but in ePub3 books you can actually assign the same semantics type to multiple files. For example, you can assign chapter to multiple .xhtml types.

Well if you thought that too, I don't feel so much of a fool as I did before.

I wonder what possessed TPTB to impose the '1 ST : 1 File' restriction in EPUB2.

But the fact that EPUB3 has dispossessed itself of that peculiarity brings me back full circle to wanting the ST in the Files Report - I use the Reports feature quite a lot. It would also be good if Files report had the means to order the files as they appear in the 'Book Browser'. I'll post a CR at gitsclub github.

I'll also convert one of my 'Test EPUBs' to EPUB3 and have a looksee

BR

[bookman156]

One stupid question: once you've added a sematic tag in Sigil, how can you remove it without editing directly in the .opf file? I presume to change one you just add another one, but to remove it altogether?

[KevinH]

It toggles. If you re-add the same semantic to the same file it will turn it off.
Kevin