Looking for Volunteers for New Chapters for Sigil User's Guide

[Banjo]

Originally Posted by odamizu

Not sure about Windows or Linux, but on Mac, the epub version is shown in the title bar, e.g., "Sigil_User_guide_2021.03.15.epub - epub2.0 - Sigil"

Converting epub2 to epub3 is done with KevinH's nifty ePub3-itizer plugin

Ah, yes. There is it in the header. I was staring at the menus and didn't look there.

Thanks for the pointer to the ePub3-itizer plugin. I will go take a look. I am writing a book that I might want to translate.

[Thasaidon]

A big Thank you to KevinH, odamizu, BeckyEbook, Banjo, DNSB, Ashjuk and everyone else who helped in updating the Sigil manual.

I really appreciate the work you have put in and look forward to finding upgrading my knowledge of Sigil when I go through it.

So on behalf of the Sigil community and myself another big thank you.

[Ashjuk]

Yes, I agree that ePub3 is the way forward for the User Guide.

[Ashjuk]

Originally Posted by Thasaidon

A big Thank you to KevinH, odamizu, BeckyEbook, Banjo, DNSB, Ashjuk and everyone else who helped in updating the Sigil manual.

I really appreciate the work you have put in and look forward to finding upgrading my knowledge of Sigil when I go through it.

So on behalf of the Sigil community and myself another big thank you.

Speaking for myself I thoroughly enjoyed being involved with the update. It was a pleasure to be able, in some small way, to put a little back into the Sigil project.

I think I learnt far more about how Sigil works by getting involved than I would have done just by reading the guide.

[Banjo]

Originally Posted by Ashjuk

Speaking for myself I thoroughly enjoyed being involved with the update. It was a pleasure to be able, in some small way, to put a little back into the Sigil project.

I think I learnt far more about how Sigil works by getting involved than I would have done just by reading the guide.

I totally agree with this. I really like Sigil and use it often. I can't help with the code so this was a perfect project to allow me to contribute.

Many thanks to the devs for keeping this wonderful tool alive.

[odamizu]

Yes! It was so nice to be able to contribute to Sigil in some small way — and to learn more about Sigil while doing it.

as always to KevinH, DiapDealer, BeckyEbook, Doitsu, and everyone else who contributes code to Sigil and its plugins. It really is a marvelous program, one I enjoy dearly.

[DiapDealer]

My sincere thanks to all who contributed in any way to the Sigil User Guide update project. You folks rock!

[ebray187]

Thank you very much for this work!
I just come to comment on a couple of details that I think could improve the manual.

First of all, each time the background color is defined, it is just as important to define the foreground color, because in color schemes with light text over dark background, the bg-text contrast is not enough for reading and may even be invisible (see the screenshots).

pre.example {
     font-family: courier, sans-serif;
     font-size: 0.85em;
     margin-left: 2em;
     margin-bottom: 1.5em;
++ color: black;
     background-color: rgb (244, 244, 244);
     white-space: pre-wrap;
}

The other, maybe it's good to embed a font that contains the symbol ➞ or replace it with an svg or something like that to ensure that it is displayed correctly.

In any case, I reiterate my thanks and congratulations for your work.
Regards.

[KevinH]

Thanks,

I can add the css stylesheet fix for the next release so something shows under a dark theme.

What font were you using that you could not see the right arrow? I tried the manual in a number of readers and they all showed the right arrow using default fonts so no font embedding was thought to be needed. Users here could see it on Windows and macOS platforms.

[Ashjuk]

Originally Posted by ebray187

The other, maybe it's good to embed a font that contains the symbol ➞ or replace it with an svg or something like that to ensure that it is displayed correctly.

Are you using Adobe Digital Editions to view the book?

Like Kevin I tried to replicate this issue in various desktop readers, and the only one that did not display the arrows was ADE.

I also noted that ADE did not handle the images very well either as you can see in the attached images.

Freda: https://www.mobileread.com/forums/at...1&d=1615804198

Calibre: https://www.mobileread.com/forums/at...1&d=1615804198

Adobe: https://www.mobileread.com/forums/at...1&d=1615804198

Image in Adobe: https://www.mobileread.com/forums/at...1&d=1615804198

[KevinH]

I will look for a thicker right indicator that is supported by ADE.

As for the images, it looks like they were poorly downsampled. What version of ADE is this?
The images look okay on my old Sony Reader which uses a quite old ADE as its back end.

[KevinH]

Both the original arrow right and arrowdblright show up in the Adobe PDF Reference manual as being included and supported by Adobe / ADE. Since the right arrow appeared too thin but the new arrow is missing, I will change it to use arrowdblright instead.

[KevinH]

Since both of these fixes will require a new release of the user-guide, I am going to convert it to a backwards compatible epub3, as was discussed earlier and update the repo as well.

[Tex2002ans]

Originally Posted by KevinH

As for the images, it looks like they were poorly downsampled. What version of ADE is this?

The images look okay on my old Sony Reader which uses a quite old ADE as its back end.

ADE has an abysmal image scaling bug that has been plaguing it for years.

It scales PNGs awfully, and Indexed PNGs even worse.

GIFs and JPGs are fine (last I remember).

It only happens in ADE, not in any RMDSK- or Readium-based readers (so actual devices/apps are fine).

[ebray187]

Just an old Nook Simple Touch (which I think uses ADE). Its great for epub testing precisely because of how fussy it is; if it work on this it usually works on all devices.
On the device the images work well, especially considering that they are only reference screenshots.

PS: Specifically the Helvetica Neue font, but the problem occurs with all fonts on the device's system.

Regards.