Skip to content

A Sigil plugin that helps users manipulate/remove spans, divs and other elements based on their attributes (or lack thereof) in a nesting-safe manner.

Notifications You must be signed in to change notification settings

dougmassay/tagmechanic-sigil-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

e75666f · Aug 3, 2023
Aug 3, 2023
Feb 25, 2022
Jan 31, 2016
Feb 11, 2020
Oct 12, 2020
Feb 24, 2022
Apr 19, 2022
Feb 24, 2022
Aug 3, 2023
Jan 13, 2022
Feb 11, 2020
Feb 11, 2020
Oct 12, 2020
Oct 15, 2020
Jun 10, 2023
Jun 10, 2023
Feb 11, 2020
Jan 14, 2022

Repository files navigation

TagMechanic (A Sigil Plugin)

A Sigil plugin that helps users manipulate/remove spans, divs and other elements based on their attributes (or lack thereof) in a nesting-safe manner.

NOTE: this plugin periodically checks for updated versions by connecting to this Github repository

Links

Building

First, clone the repo and cd into it:

$ git clone https://github.com/dougmassay/tagmechanic-sigil-plugin.git
$ cd ./tagmechanic-sigil-plugin

To create the plugin zip file, run the buildplugin.py script (root of the repository tree) with Python (2 or 3)

$./buildplugin (so long as buildplugin's executable bit is set, otherwise ... $python ./buildplugin)

This will create the TagMechanic_vX.X.X.zip file that can then be installed into Sigil's plugin manager.

Contributing / Modifying

From here on out, a proficiency with developing / creating Sigil plugins is assumed. If you need a crash-course, an introduction to creating Sigil plugins is available at http://www.mobileread.com/forums/showthread.php?t=251452.

The core plugin files (this is where most contributors will spend their time) are:

> dialogs.py
> plugin.png
> plugin.svg
> parsing_engine.py
> plugin.py
> plugin.xml
> utilities.py

Files used for building/maintaining the plugin:

> buildplugin  -- this is used to build the plugin.
> checkversion.xml -- used by automatic update checking (not yet implemented).
> setup.cfg -- used for flake8 style and PEP checking. Use it to see if your code complies.
(if my setup.cfg doesn't bark about it, then I don't care about it)

Feel free to fork the repository and submit pull requests (or just use it privately to experiment).

Files used for translations: > translations/template.ts

To any potential volunteer translators: There's nothing terribly complicated. Just a bunch of strings strings that probably won't be changing much (if at all) in the future. Contact me if you're interested in translating the plugin. The gist is this: fork the repo; copy the template.ts file (in the translations folder) to tagmechanic_(pl|es|fr).ts (or whatever your language's code is) and use Qt's Linguist to translate the strings. Then submit a pull request and I'll compile the language files for use in the plugin.

License Information

TagMechanic (a Sigil plugin)

Licensed under the GPLv3.

About

A Sigil plugin that helps users manipulate/remove spans, divs and other elements based on their attributes (or lack thereof) in a nesting-safe manner.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages