Mobileread
Looking for Volunteers for New Chapters for Sigil User's Guide
#1  KevinH 02-10-2021, 10:21 AM
Hi All,

EDIT: The update is now complete as of March 12th, 2021


Given the feature and ui changes, Sigil's User Guide really really needs updating and some new chapters added.

The possible new chapters relate to:

1. Sigil's new Icon themes including what each icon means in each set, how to select one of the pre-installed icon themes in Preferences and how to set your own custom icon theme. (Edit: Done in Custom UI chapter)

2. An improved discussion of Plugins for users. Including where to find them, how to install them, how to remove them, how to assign icons to plugin placeholders, etc. Perhaps including a very brief summary of some of the major plugins out there: epubcheck, flightcrew, KindleImport, ODTImport, Kindlegen, epub3-itizer, Access-Aide, etc, etc. (Edit: To be handled in Manage Plugins Chapter)

3. A chapter on changing an epub's internal folder names and paths, moving and renaming files using move and rename and the regular expression renaming. How to change file extensions, how to "standardize to old Sigil's folder structure", how to create a default custom empty epub. (Edit: Handled in various places but more could be done about Custom Default Layouts in a future version of the user guide).


And on top of all of that, we have updated the photos and modernize all existing chapters to show the existing menu structure and functions while keeping the wonderful existing tutorials on clips, and indexing and other things.


So if anyone would like to help give back to Sigil, updating just one existing chapter or adding just one new chapter would be a wonderful way to give back and help others all at the same time!

As a standard we can all use the default main icon set for any images so that new users are shown a consistent interface.

So if anyone is willing to help with just one chapter, please post to this thread which one you are willing to take lead on (current chapter or proposed) so duplication of efforts is minimized.

I will do all of the merging back into the user manual to help make things easier.

The very latest user's guide can be found in repository form here:

https://github.com/Sigil-Ebook/sigil-user-guide

and in epub form can be found attached to this post as:

Sigil_User_Guide_2021.03.18_epub3.epub


Thanks to all volunteers who have helped!
KevinH


-- Update --

A repository with some updated screenshots is available here:

https://drive.google.com/drive/folders/1XApbJUXtpHaEoxSj8UE03ldjIG-Cvks7


All chapters have now been claimed and edited and a final cleanup has been done. It should be final.
[epub] Sigil_User_Guide_2021.03.18_epub3.epub (5.67 MB, 22 views)
Reply 

#2  odamizu 02-10-2021, 03:25 PM
I would like very much to contribute, but in reading the current User Manual, I realize how much of a Sigil novice I am. There are a lot features I don't understand, and even more that I never use. (I just use Sigil to tweak epubs to my liking.)

If there aren't enough volunteers, I can probably make some basic updates to basic chapters (perhaps with some blanks for more advanced users to fill). I figure basic updates are better than no updates at all? But it's probably better to wait a bit and see if more advanced users volunteer, since inaccurate updates from me would be worse than no updates.
Reply 

#3  KevinH 02-10-2021, 03:40 PM
Even just recreating the existing chapter images as closely as possible via well done screen captures and some editing if needed would be a big help.

If you use the existing image file name then I can copy them to overwrite what is there now one for one. Please use the default main icon set and light (not dark) mode for consistency.

Just updating the images of one or a couple chapters would help.
Reply 

#4  odamizu 02-10-2021, 03:55 PM
Okay. I'm thinking of taking the first two Features chapters: "User Interface" and "Preferences". Would that make sense?

When I'm done, can I send you the complete working epub with the updated chapters for you to extract? Or do you just want me to send you the updated chapter files and new images? I'm not sure best way to do this. Also, I don't understand GitHub.
Reply 

#5  KevinH 02-10-2021, 04:02 PM
Just zip up any modified files and post them as an attachment to this thread so that everyone can see them. I will merge them into the repository myself.

Thanks for helping out!
Reply 

#6  odamizu 02-10-2021, 04:34 PM
Okay, I will work on: User Interface and Preferences
Reply 

#7  Ashjuk 02-11-2021, 05:12 AM
As much as I would love to help out I stumble around in the dark most of the time with Sigil as it is, so I doubt I would be able to provide anything better than you have now.

However, I do have screen capturing software that can capture selected areas of the screen. So if someone needs some screen shots done to go with their text, I am more than happy to help.
Reply 

#8  KevinH 02-11-2021, 10:01 AM
Thanks! Anything would help. FWIW, there are a few chapters that need no text changes and just updating the screen shots would be enough.

For those willing to help, we can make an early pre-release version of Sigil 1.5.0 Beta available to make screenshots with.

Thank you.

Kevin


Quote Ashjuk
As much as I would love to help out I stumble around in the dark most of the time with Sigil as it is, so I doubt I would be able to provide anything better than you have now.

However, I do have screen capturing software that can capture selected areas of the screen. So if someone needs some screen shots done to go with their text, I am more than happy to help.
Reply 

#9  Ashjuk 02-11-2021, 11:28 AM
Quote KevinH
Thanks! Anything would help. FWIW, there are a few chapters that need no text changes and just updating the screen shots would be enough.

For those willing to help, we can make an early pre-release version of Sigil 1.5.0 Beta available to make screenshots with.

Thank you.

Kevin
OK - I will have a look at the existing manual's screen shots and compare them with the current version of Sigil.

If any need updating I will upload the new image to an image hosting site for anyone to download.
Reply 

#10  odamizu 02-11-2021, 01:56 PM
Quote KevinH
... For those willing to help, we can make an early pre-release version of Sigil 1.5.0 Beta available to make screenshots with.
I'm game. If you think it makes sense to use Sigil 1.5.0 Beta for the updates, let me know how to download. Otherwise I'll use 1.4.3.
Reply 

  Next »  Last »  (1/29)
Today's Posts | Search this Thread | Login | Register