Looking for Volunteers to help update Sigil Users Guide

[KevinH]

Hi All,

Our Sigil User's Guide is still at Sigil 1.9.10 level and there has been a number of gui and preferences changes since then.

I would like help from volunteers to bring the manual up to the level of the forthcoming Sigil 2.3.0 (which is in Beta now).

The bulk of the text is fine as is, but additions for new features like the tool to rebase opf manifest ids, a new Bookmark icon, changes to drop high dpi settings, the ability to add and link blank javascript files in BookBrowser, the new Find and Replace settings, new Focus moving menu items, and etc means many screenshots and some text will need to be changed and updated.

I will generate a list of the major changes since Sigil 1.9.10 and post them here.

Once I have done that I would love for people to volunteer to update one or more chapters of the User's Guide (like we did once before) by claiming them in this thread first - to prevent duplication of effort.

We will make a near final pre-release build of Sigil-2.3.0 for use by volunteers to use for screenshots.

Thank you in advance for anyone that volunteers to help update any chapter.

[KevinH]

This place reserved for list of new or changed features since Sigil 1.9.10:

Changes that probably need to be added to the Sigil Users's Guide

-  use of new template files:
    user-template*.xhtml, user-template*.css, cover-template*.xhtml

- ability to cycle through 2 different custom stylesheets (or none) for Preview with an icon click, and where to put those custom Preview css files

- use of Print and Print Preview for xhtml and image tabs, a Sigil's Preview

- document new Preferences to set the Print DPI

- ability to add and edit descriptions for each Checkpoint made

- document the location of Sigil's temp and working files inside the Sigil Preferences folder in the "workspace" folder.

- document new and existing Environment variables, perhaps in a new environment variable chapter, picking up the existing ones and adding the following new ones:
    SIGIL_ALLOW_CODEVIEW_DROP,
    SIGIL_USE_FREETYPE_FONTENGINE
    SIGIL_PREVIEW_TIMEOUT
    SIGIL_DISABLE_NFC_NORMALIZATION

- document the ability to embed a PDF in an epub (supported by ADE and other EPub3 readers) with screen caps

- new menus for advanced keyboard navigation:
    P - &Plugin accelerator
    K - Chec&kpoint accelerator
    Focus On * (one of the qdockwidgets)
    Use of tab to shift focus and (shift tab / backtab)

- document new Accessibility features and their Preferences
    Show Focus Rectangles
    Double Width Cursor

- document new live switching of Dark to Light Mode on Windows and Linux to feature match MacOS, and associated Preferences changes.

- document changes in Find Replace, new Targets
    Selected SVG
    Selected Javascript
    Selected Misc XML files

- document changes in Find and Replace - new regex flag Unicode Proerty (*UCP)

- document changes in Find and Replace using hex to specify unicode: \x{hhhh}

- document that the new max is 60 clips for the new Clips toolbars (30 per bar)

- document the removal of the HighDPI Preference settings.

- document the new Bookmark icon and its toolbar location in screen capturesand text

- document the new epub tool to rebase all manifest ids on current filenames with screen caps of the opf tab  before and after

[KevinH]

I did not realize the list of changes was so long, but the biggest changes will happen in chapters on Preferences, Find and Replace, Advanced Find and Replace, User Interface, and in most of the images needing to be updated.

Any and all help would be greatly appreciated!

[KevinH]

Okay for those interested in helping bring the Sigil Users Guide up to date with the latest feature set (see 2 posts above) for the forthcoming Sigil 2.3.0 I have posted CI built Beta2 builds of today's master here:

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

The 3 files are:

Sigil-2.3.0-Beta2-Windows-x64-Setup.exe

Sigil.app-2.3.0-Beta2-Mac-arm64.tar.xz

Sigil.app-2.3.0-Beta2-Mac-x86_64.tar.xz

FYI: As these are Beta2 builds, none of them are signed but they are created by our own Github test build code via github actions.


So what I am looking for is that each volunteer to claim a single chapter at a time from our Sigil User Guide, reading it over and looking at the list of new features in the post 2 above and adding/modifying that chapter to include anything thing from that new feature list that might be relevant to their chapter. Updating any screenshots if needed.

Then upload just the changed chapter files and any images in a zip archive and attach it in a post in this thread.

Many chapters will hopefully not need any updating at all. Some will just need new screen capture images.

I will then collect all changed chapters and any support files and update them in the Sigil Users Guide itself.

Many thanks in advance for any help. Keeping up the Sigil Users Guide is very important but we just do not have enough volunteer time to handle that and create new code, releases, and features for Sigil. So any help will be welcome.

Thanks!

[KevinH]

The very latest Sigil User Guide can be downloaded from here:

https://github.com/Sigil-Ebook/sigil...tag/2022.05.17

[KevinH]

Here is a list of the text files in the Sigil User Guide that really do need to be updated.

Spoiler:

• add_cover.xhtml
• find_replace.xhtml
• preferences.xhtml
• preview.xhtml
• saved_searches.xhtml
• user_interface.xhtml
• ui_customize.xhtml

The following still need to be checked to see if any changes or updates are even needed:

Spoiler:

• contributing_to_sigil.xhtml
• faq.xhtml
• toc.xhtml
• tutorial_add_cover.xhtml
• tutorial_advanced_find.xhtml
• tutorial_code_view.xhtml
• tutorial_convert_to_html.xhtml
• tutorial_embed_fonts.xhtml
• tutorial_find_replace.xhtml
• tutorial_generate_toc.xhtml
• tutorial_links.xhtml
• tutorial_load_file.xhtml
• tutorial_mark_chapters.xhtml
• tutorial_metadata.xhtml
• tutorial_regex_reference.xhtml
• tutorial_save.xhtml
• tutorial_spelling.xhtml
• tutorial_split.xhtml
• tutorial_stylesheets.xhtml
• tutorial_tips.xhtml

I will update these lists as chapters are claimed and updated if needed and remove them when the updating is complete.