## 1. Project Overview & Quickstart (Sigil-Ebook/Sigil) Sigil ===== Sigil is a free, open source, multi-platform ebook editor that uses Qt6 (and QtWebEngine). It is designed to edit books in ePub format (both ePub 2 and ePub 3). Links ===== * Its website is located at http://sigil-ebook.com * Its current code repository is located at https://github.com/Sigil-Ebook/Sigil * Translations are located at https://app.transifex.com/zdpo/sigil * Support forums are located at http://www.mobileread.com/forums Select Sigil from the list of main forums * Sigil Plugin Index (hosted by www.mobileread.com) at http://www.mobileread.com/forums/showthread.php?t=247431 * Sigil User Guide is located at https://github.com/Sigil-Ebook/sigil-user-guide/releases/latest * An online version of the User Guide is available at: https://sigil-ebook.com/sigil-user-guide Issue Tracker ============= Please do not use the issue tracker to ask questions or suggest new features. Both of the main developers of Sigil monitor the Sigil Forum at https://www.mobileread.com/forums. All questions and feature requests should be directed there so that other interested users can help or comment. Issue tracking is intended for discussion around issues with the code. It is also intended for actual bug tracking. Feature requests opened on the issue tracker will be closed. Linux Build and Install ======================= Starting with Sigil 2.3.0, Qt6.4 is the minimum requirement to build Sigil. You'll need to use an older version if you need to build with Qt5. For newer Linux systems like Ubuntu 23.04 (and its derivatives), or Arch Linux, or Debian Trixie or Unstable, you should be able to compile Sigil using repo-provided dependencies. Instructions for doing so can be found in: > [docs/Building_on_Linux.md](./docs/Building_on_Linux.md) The Qt6 build documentation strives to provide both Debian- and Arch-based package names. For older Linux systems whose software repositories do not provide Qt6.4.0 (or higher), the detailed instructions for building/installing Sigil with Qt5 can be found in: > [docs/Building_on_Linux_older.md](./docs/Building_on_Linux.md) If your distro's Sigil package seems to be lagging too far behind. An up-to-date version of Sigil built by us is now part of our releases as an AppImage. For Building on Mac OS X ======================== Building using purely XCode is no longer supported on Mac OS X. The easiest way to build Sigil on Mac OS X is to use cmake 3.X and the XCode CommandLineTools. Also because Sigil now embeds Python 3.14.2, see > [docs/Building_A_Relocatable_Python_3.14_Framework_on_MacOSX.txt](./docs/Building_A_Relocatable_Python_3.14_Framework_on_MacOSX.txt) for detailed instructions on how to build a fully relocatable Python 3.14.2 framework before building Sigil. For official releases Sigil uses Qt6.10.2 plus official local patches see: > [docs/Building_Qt6_From_Source_on_MacOSX.txt](./docs/Building_Qt6_From_Source_on_MacOSX.txt) And finally to build Sigil itself see: > [docs/Building_Sigil_On_MacOSX_With_Qt6.txt](./docs/Building_Sigil_On_MacOSX_With_Qt6.txt) For Installing/Building on Windows ================================== Sigil currently provides a Windows installer for x64 and will work on Windows 10 (1809) or newer. The latest Sigil versions are also typically available via the [winget (Windows 10+)](https://winstall.app/apps/Sigil-Ebook.Sigil), [Chocolatey (Windows 10+)](https://community.chocolatey.org/packages/Sigil), and [Npackd](https://npackd.appspot.com/p?q=sigil) Windows package managers. There are no "scary" Microsoft warnings about unknown publishers if you install Sigil via one of these package managers. To build Sigil on Windows yourself, see: > [docs/Building_Sigil_on_Windows_with_Qt6.md](./docs/Building_Sigil_on_Windows_with_Qt6.md). License ======= Sigil is licensed under the GPLv3. The complete license is located in COPYING.txt. Note that libraries and components Sigil used and bundles may use a different license (that is compatible with the GPLv3) from Sigil. See the specific component for their respective license. The source code from these projects can be found under Sigil/3rdparty unless otherwise indicated. Please see their respective folders for complete license information. Currently these projects include: * Hunspell 1.7.2 - https://github.com/hunspell/hunspell * MiniZip version 1.1 (plus some security changes) * Perl-compatible Regular Expression Library 2 (pcre2 version 10.46) * ZLib Data Compression Library (zlib 1.3.1) * jQuery-3.6.4 (src/Resource_Files/javascript/jquery-3.6.4.min.js) * jQuery.ScrollTo-2.1.2 (src/Resource_Files/javascript/jquery.scrollTo-2.1.2.min.js) * MathJax.js Version 3.2.X [required minimum is 3.2.2]: (src/Resource_Files/polyfills) In addition, Sigil uses the following other third party packages that have been specifically modified for use inside Sigil: * Beautiful Soup 4 (src/Resource_Files/plugin_launchers/sigil_bs4) * Sigil-gumbo based on Google's Gumbo Parser (internal/gumbo) * lexbor (css and core module) from https://github.com/lexbor/lexbor/ current master Sigil in Action =============== Sigil Main Window Dark Mode Generate ToC Python3 Plugins Edit Metadata Run Reports Detect Changes Preview's Inspector Customize Your Layout Validate EPUB, CSS, XHTML, etc. Interface to PageEdit Visual XHtml Editor Package Versions of Sigil ========================= [](https://repology.org/project/sigil/versions) ## 2. Official Technical Reference & Guides (Sigil-Ebook/sigil-user-guide) # This is the repository for the Sigil User Guide [View this user guide online](https://sigil-ebook.com/sigil-user-guide) ## Guidelines for contributing 1. __NO ARTISTIC/AESTHETIC CHANGES PLEASE!__ We're only interested in content updates and corrections, or updated screenshots that show new menus or new features. If you're hoping to "jazz things up" or redo the the style of the epub to reflect your personal style or formatting preferences, you're probably going to be disappointed. Pull Requests that include stylistic changes or "upgrades" will be declined (unless such work has been pre-approved of course). 2. __Less is best__. Several smaller, tightly focused Pull Requests are always going to be preferred over ones that represent grand, sweeping changes to large swathes of the manual. We don't want to have to read the entire manual each and every time we're evaluating a new Pull Request. Neither would you. Be considerate if you want to see your efforts incorporated. 3. __Don't Break anything__. Changes that break the resulting epub or cause validation issues will be rejected. It's your responsibility to make sure the epub structure remains intact and spec compliant. ## Preferred Workflow - Fork this repository to your own Github account and clone a local copy of it to your computer. - Use the [FolderIn Sigil plugin](https://www.mobileread.com/forums/showthread.php?t=293649) to load the contents of the "src" directory of your local, cloned repository into Sigil. - Do your editing (saving changes to a local temporary epub somewhere if you must). Remember to use "Mend and Prettify" after you're done, and always make sure the epub validates with no errors. Then when ready, save the contents back to the "src" directory of your local, cloned repository using the [FolderOut Sigil plugin](https://www.mobileread.com/forums/showthread.php?t=293649). - Use the normal git tools to check your differences and then when satisfied, commit and push your changes to your Github fork. - Create a new Pull Request from your Github account so that we can review and hopefully pull your changes into the project. ---- If you run into trouble, feel free to ask for help at the [Sigil Support forums on Mobileread](https://www.mobileread.com/forums/forumdisplay.php?f=203).