Looking for Volunteers for New Chapters for Sigil User's Guide - Page 17

Ashjuk · 03-11-2021, 09:23 AM

Quote:

Originally Posted by KevinH

@Ashjuk,

When you get a free moment, would you please generate two images of the default Sigil app showing the same interesting page from "Alice's Adventures in Wonderland" with a nice illustration showing in Preview. One in Window's Dark Mode and One in Windows normal. Then squeeze them down for me.

I would like to use them when adding Dark Theme support info to the User-guide showng the same image in both modes.

Thanks!

KevinH

Will do!

Update:

I have tried all the settings I can find and whatever I do Sigil still displays as normal. The closest I could get to a 'dark mode' was to turn of High Contrast but all that seemed to do was change the colour of the menu bar.

To be honest I have never used dark mode so I really don't know how it works.

I have attached two images for you to have a look at.

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

KevinH · 03-11-2021, 09:41 AM

Hi All,

Here (attached) is a screen shot of how I modified the ui_customize chapter at the beginning to talk about Dark vs Light themes.

I will also add in two images from Ashjok to show what Dark and Light themes look like..

Once I get those images and integrate them, I will post the hopefully last version before final clean-up.

All comments and fixes welcome!

Ashjuk · 03-11-2021, 09:55 AM

Quote:

Originally Posted by BeckyEbook

Consider <p> as a unique "non-header" style.
I think it is also about years of user habituation, so personally, it does not bother me.

Quote:

Originally Posted by KevinH

Exactly. It allows you to change from any Heading back to Normal without needing to hand edit tags.

Fair enough - just wondering that's all.

Ashjuk · 03-11-2021, 10:01 AM

Quote:

Originally Posted by KevinH

Hi All,

Here (attached) is a screen shot of how I modified the ui_customize chapter at the beginning to talk about Dark vs Light themes.

I will also add in two images from Ashjok to show what Dark and Light themes look like..

Once I get those images and integrate them, I will post the hopefully last version before final clean-up.

All comments and fixes welcome!

Thanks Kevin.

Having read your text I could see where I was going wrong - I already had Sigil running when I changed to Dark Mode.

Dark Mode image attached.

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

KevinH · 03-11-2021, 10:48 AM

Wonderful! Thank you!

I will add them into the updated user_guide, post it to the first issue in thread, and update the repo!

Thanks,

KevinH

Quote:

Originally Posted by Ashjuk

Thanks Kevin.

Having read your text I could see where I was going wrong - I already had Sigil running when I changed to Dark Mode.

Dark Mode image attached.

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

theducks · 03-11-2021, 10:55 AM

Quote:

Originally Posted by BeckyEbook

Consider <p> as a unique "non-header" style.
I think it is also about years of user habituation, so personally, it does not bother me.

I use the to UN-header existing tags (made by those that still seem to style by tag

) (which trips up Calibre split on headers, when it is not panted. Commonly found on Title pages)

KevinH · 03-11-2021, 11:19 AM

Hi All,

Okay, I have added in the new dark and light theme images (thank you Ashjuk!) and the final edited chapters from odamizu (find and replace, and saved searches) (thank you odamizu!).

So the user-guide should now be ready for final cleanup!

See the first post for the attached src_updated_20210311_01.epub.

All of these changes have now been pushed to the sigil-user-guide repo as well.

@BeckyEbook it should be all yours now!

BeckyEbook · 03-11-2021, 11:27 AM

I just downloaded the latest version from the first post.

KevinH · 03-12-2021, 11:17 AM

Thank you BeckyEbook for your cleanups and improvements!

The final version of the Sigil User Guide is now available:

See the first post for:

Sigil_User_Guide_2021.03.15.epub

It has also been added to the Sigil master docs/ folder and of course all changes have been pushed to our sigil_user_guide repository on github.

See https://github.com/Sigil-Ebook/sigil...guide/releases for official user guide releases

One final question for your feedback:

Since the current Sigil User Guide is only in EPUB2 format that does not accept added Accessibility improvements as well as an EPUB3 version could, should future releases of the Sigil User Guide be converted to the EPUB3 format (adding in Accessibility roles) but include a backwards compatible NCX and Guide.

I think this is the way to go forward, but wanted to hear people's thoughts before making that change.

Thanks again to all who helped!

DNSB · 03-12-2021, 12:15 PM

Quote:

Originally Posted by KevinH

One final question for your feedback:

Since the current Sigil User Guide is only in EPUB2 format that does not accept added Accessibility improvements as well as an EPUB3 version could, should future releases of the Sigil User Guide be converted to the EPUB3 format (adding in Accessibility roles) but include a backwards compatible NCX and Guide.

I think this is the way to go forward, but wanted to hear people's thoughts before making that change.

Thanks again to all who helped!

I would agree that is the way to go forward.

odamizu · 03-12-2021, 02:31 PM

Quote:

Originally Posted by KevinH

... should future releases of the Sigil User Guide be converted to the EPUB3 format (adding in Accessibility roles) but include a backwards compatible NCX and Guide.

I think this is the way to go forward, but wanted to hear people's thoughts before making that change.

Quote:

Originally Posted by DNSB

I would agree that is the way to go forward.

I agree as well.

Banjo · 03-12-2021, 03:09 PM

Quote:

Originally Posted by KevinH View Post
... should future releases of the Sigil User Guide be converted to the EPUB3 format (adding in Accessibility roles) but include a backwards compatible NCX and Guide.

I think this is the way to go forward, but wanted to hear people's thoughts before making that change.

Sounds good to me.

BTW, how does one translate an existing EPUB2 into EPUB3?

And how does one find out which format an existing book is in?

I don't see anything obvious in the menus.

odamizu · 03-12-2021, 03:17 PM

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

Quote:

Originally Posted by Banjo

...

BTW, how does one translate an existing EPUB2 into EPUB3?

And how does one find out which format an existing book is in?

I don't see anything obvious in the menus.

KevinH · 03-12-2021, 03:22 PM

Yes, the plan would be running both ePub3-itizer and then AccessAide on it (in that order) to convert it to epub3, add in any missing titles, add in xml:lang and lang, add in the aria roles where indicated, add in the Accessibility Metadata, improve all of the image alt tags to try to be much more descriptive, etc.

KevinH · 03-12-2021, 03:40 PM

Since people seem to be in agreement, I can make those changes in time for the Sigil-1.6.0 release, sometime after the upcoming Sigil 1.5.0 release.

03-11-2021, 09:41 AM	#242
KevinH Sigil Developer Posts: 8,860 Karma: 6120478 Join Date: Nov 2009 Device: many	Hi All, Here (attached) is a screen shot of how I modified the ui_customize chapter at the beginning to talk about Dark vs Light themes. I will also add in two images from Ashjok to show what Dark and Light themes look like.. Once I get those images and integrate them, I will post the hopefully last version before final clean-up. All comments and fixes welcome! Attached Thumbnails

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Wanted: Volunteers to Update the Sigil User's Guide	KevinH	Sigil	55	05-18-2018 02:52 AM
Sigil Improvement Projects for Developers/Volunteers	KevinH	Sigil	19	06-27-2016 06:19 PM
Sigil and chapters.	p3aul	Sigil	5	11-29-2012 09:23 PM
Sigil + Adobe Digital Editions + chapters	wkuiper	Sigil	6	11-23-2012 10:58 AM
Sigil and epub (can I delete empty chapters?)	desaderal	Sigil	3	03-24-2011 07:57 AM

03-11-2021, 11:19 AM	#247
KevinH Sigil Developer Posts: 8,860 Karma: 6120478 Join Date: Nov 2009 Device: many	Hi All, Okay, I have added in the new dark and light theme images (thank you Ashjuk!) and the final edited chapters from odamizu (find and replace, and saved searches) (thank you odamizu!). So the user-guide should now be ready for final cleanup! See the first post for the attached src_updated_20210311_01.epub. All of these changes have now been pushed to the sigil-user-guide repo as well. @BeckyEbook it should be all yours now!

03-11-2021, 11:27 AM	#248
BeckyEbook Guru Posts: 854 Karma: 3341026 Join Date: Jan 2017 Location: Poland Device: Various	I just downloaded the latest version from the first post.

03-12-2021, 11:17 AM	#249
KevinH Sigil Developer Posts: 8,860 Karma: 6120478 Join Date: Nov 2009 Device: many	Thank you BeckyEbook for your cleanups and improvements! The final version of the Sigil User Guide is now available: See the first post for: Sigil_User_Guide_2021.03.15.epub It has also been added to the Sigil master docs/ folder and of course all changes have been pushed to our sigil_user_guide repository on github. See https://github.com/Sigil-Ebook/sigil...guide/releases for official user guide releases One final question for your feedback: Since the current Sigil User Guide is only in EPUB2 format that does not accept added Accessibility improvements as well as an EPUB3 version could, should future releases of the Sigil User Guide be converted to the EPUB3 format (adding in Accessibility roles) but include a backwards compatible NCX and Guide. I think this is the way to go forward, but wanted to hear people's thoughts before making that change. Thanks again to all who helped!

03-12-2021, 03:22 PM	#254
KevinH Sigil Developer Posts: 8,860 Karma: 6120478 Join Date: Nov 2009 Device: many	Yes, the plan would be running both ePub3-itizer and then AccessAide on it (in that order) to convert it to epub3, add in any missing titles, add in xml:lang and lang, add in the aria roles where indicated, add in the Accessibility Metadata, improve all of the image alt tags to try to be much more descriptive, etc.

03-12-2021, 03:40 PM	#255
KevinH Sigil Developer Posts: 8,860 Karma: 6120478 Join Date: Nov 2009 Device: many	Since people seem to be in agreement, I can make those changes in time for the Sigil-1.6.0 release, sometime after the upcoming Sigil 1.5.0 release.