Skip to content

This Sigil plugin is used to open a console to edit ePub.

License

Notifications You must be signed in to change notification settings

ChenyangGao/sigil-console

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sigil-console

sigil-console 是一个 Sigil 插件,可以在控制台中交互式地输入并运行 python 代码。利用 Sigil 提供的 python 接口,可以读写当前正在用 Sigil 操作的 ePub 书。

配置

运行插件后,只要当前的 python 执行环境的 tkinter 模块可用,则会弹出如下的配置界面。

如果用鼠标在上面的配置界面中的一些地方悬停几秒,就会弹出相应的提示说明,你可以通过阅读这些提示说明,来了解如何进行配置。
配置完成后,直接关闭配置界面的窗口,就会生效。

基本操作

1. 选择并进入 console

在配置界面中选择一个特定的 console 后,关闭窗口,就会自动打开对应的 console

我个人推荐你选择 ipython,后面的示例代码我都会用 ipython 执行。

如果没有自动加载环境,就需要你手动加载。你也可以在 console 中运行一个 sigil_console_startup.py 文件,来加载环境。sigil_console_startup.py 文件的路径如下图(每一次运行插件后,路径都不同):

2. 退出 console

退出需要运行专门的命令,直接关闭窗口可能会丢弃修改
所有的 console 中,你都可以通过运行(输入后回车) exitexit()plugin.exit() 命令退出。
有些支持输入 Ctrl-DCtrl-Q 组合键退出。但在 idle*euporie 下,会丢弃修改
jupyter labjupyter notebook 打开后,会先打开一个命令行终端,再在终端运行一个网页服务,你写代码是在网页上,但需要在命令行终端输入 Ctrl-C 退出。

3. 运行命令

在命令行中输入 python 代码或命令,回车后就会运行。这里所谓的命令行,运行着上面提到的某个 console,并有着一种称为 REPL 的运行方式,提供了一种反复地【输入-运行-输出】的交互式工作流程。

下图展示了,在 ipython console 中运行了几个命令:

4. 调用 Sigil 的 python 接口

具体有哪些接口,可参考文档 Routines to Access and Manipulate OPF elements,你可以在 bc 或者 bk 上调用这些接口,bcbk 是同一个东西,只是名字不同,你可以根据喜好选用其一。

In [1]: bc
Out[1]: <bookcontainer.BookContainer at 0x108c41fc0>

In [2]: bk
Out[2]: <bookcontainer.BookContainer at 0x108c41fc0>

In [3]: list(bc.text_iter())
Out[3]: [('Section0001.xhtml', 'Text/Section0001.xhtml')]

5. plugin.*

我提供了很多帮助函数,作为全局变量 plugin 的属性提供,可阅读来了解文档,也可以用 help() 函数来查看说明文档。

6. editor.*

我提供了很多便于操作 ePub 的函数,作为全局变量 editor 的属性提供,可阅读来了解文档,也可以用 help() 函数来查看说明文档。

7. 安装和删除模块

当前的 python 环境中有 pip 时,可以使用 plugin.install() 函数安装第三方模块,plugin.uninstall() 函数删除第三方模块。

使用实例

详细资料,请参考 官方文档

1. 添加和删除文件

  1. 运行下面的命令,可以在当前正在操作的 ePub 书中添加一个 id 和 名字 为 Sectionxxxx.xhtml 的文件:
text = '''<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <title></title>
</head>

<body>
  <p>&nbsp;</p>
</body>
</html>'''

fileid = filename = 'Sectionxxxx.xhtml'
# 可以省略 mime 参数,如此会自动根据后缀名判断 mimetype
bc.addfile(fileid, filename, text, mime='application/xhtml+xml')
  1. 运行下面的命令,可以删除一个 id 为 Sectionxxxx.xhtml 的文件:
bc.deletefile('Sectionxxxx.xhtml')

2. 读写文件

  1. 运行下面的命令,可以读取一个 id 为 Sectionxxxx.xhtml 的文件内容:
bc.readfile('Sectionxxxx.xhtml')
  1. 运行下面的命令,可以修改一个 id 为 Sectionxxxx.xhtml 的文件内容:
text = '''<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <title></title>
</head>

<body>
  <p>&nbsp;</p>
</body>
</html>'''

bc.writefile('Sectionxxxx.xhtml', text)

About

This Sigil plugin is used to open a console to edit ePub.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published