Plugin Development

[Doitsu]

Originally Posted by Capricorn

What tools and websites are good to learn python?

I'd strongly recommend Automate the Boring Stuff with Python by Al Sweigart, which is available for free online.
You'll also need to download the Sigil Framework Guide.
You also might find the Sigil test plugin helpful because it demonstrates most Sigil-specific Python functions.

Here's a minimal proof-of-concept edit plugin that will wrap "the" in all html files in <b> tags:

#!/usr/bin/env python
# -*- coding: utf-8 -*-
import sys, os

# main routine    
def run(bk):
    # iterate over all html files
    for html_id, href in bk.text_iter():
        # read orignal html code from file
        original_html = bk.readfile(html_id)
        # modify html code
        modified_html = original_html.replace('the', '<b>the</b>') 
        if modified_html != original_html:
            # write modified html code to file
            bk.writefile(html_id, modified_html)
            print(os.path.basename(href) + ' updated')
    return 0

def main():
    print('I reached main when I should not have\n')
    return -1

if __name__ == "__main__":
    sys.exit(main())

As you can see it doesn't really require much code. BTW, Sigil comes with a fork of the BeautifulSoup library that makes it really easy to manipulate HTML content. To import it you must use:

from sigil_bs4 import BeautifulSoup

[KevinH]

Just to be clear ...

Sigil plugins only allow batch processing of files inside a single loaded epub. If you want to batch process a number of epubs without having to load them in Sigil, python is the way to go but not Sigil Plugins.

That said the python modules in Sigil could be extracted and used in a standalone python program with only low to moderate effort.

[theducks]

Originally Posted by DiapDealer

The markup in mobi files was full of small, medium, large, x-small, xx-large, and normal font sizes.

The mobi2xhtml script in the kindleinport plugin has a routine that tried to make some sort of sense out of it:

https://github.com/dougmassay/kindle...2xhtml.py#L358

I made a Sigil Saved Grouped Search that changes those name into ##em (except Normal is just deleted) (I used to have to do a lot of 'cleanup' on older files from the Baen CD's or Free Library.
This is one of the reasons I use Sigil for some tasks and Calibre Editor for others. They fit MY workflow (please keep doing Sigil things, the Sigil way), and Calibre does others.
All we need to do is learn to use the tools we have without making those other folk that want the other way (either editor) use OUR way.
Only if it is broken, does it need fixin'

[Capricorn]

Originally Posted by Doitsu

I'd strongly recommend Automate the Boring Stuff with Python by Al Sweigart, which is available for free online.
You'll also need to download the Sigil Framework Guide.
You also might find the Sigil test plugin helpful because it demonstrates most Sigil-specific Python functions.

Thanks. I will get this book and see where it leads.