Skip to content

Commit abc59b9

Browse files
committed
docs: 更新readme
1 parent ff473e4 commit abc59b9

2 files changed

Lines changed: 18 additions & 12 deletions

File tree

README.md

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,10 @@ graph LR
4747
> ```
4848
>
4949
> 当请求打印服务的 ip 是 localhost,因为浏览器的安全策略,http 请求会因跨域出错.
50-
> **此时建议使用 websocket 的方式**
50+
> **建议使用 websocket 的方式**
51+
52+
53+
5154
5255
## 0-安装
5356
@@ -67,12 +70,13 @@ linux 版本使用 nix 做成了一个沙箱程序(glibc 都包含),可以在复
6770
但是有这些问题:
6871
6972
1. 包体积实在是太大了,600 多 M
70-
2. qt 后台**最佳**渲染机制在不同桌面环境是不同的,还和硬件即驱动有关.所以不可能在沙箱环境中编译出完全适配所有 linux 发行版的程序.因此在运行程序时设置变量`QT_XCB_GL_INTEGRATION=none QT_QUICK_BACKEND=software`,参考代码中的 r.sh,这导致程序会变慢一些
73+
2. qt 后台**最佳**渲染机制在不同桌面环境是不同的,还和硬件驱动有关.所以不可能在沙箱环境中编译出完全适配所有 linux 发行版的程序.因此在运行程序时设置变量`QT_XCB_GL_INTEGRATION=none QT_QUICK_BACKEND=software`(参考代码中的 r.sh),这导致程序会变慢一些
7174
3. 因为是在沙箱,也就是隔离环境中运行,所以不能调用 host 的程序,所以最后一步 LastProcess 不能使用
75+
4. 第一次打开需要解包,很慢,所以耐心等待...
7276
7377
### 0.3 配置文件
7478
75-
位于当前用户根目录`.WebpagePrinter`文件夹下.
79+
程序打开时会创建配置文件,位于当前用户根目录`.WebpagePrinter`文件夹下.
7680
7781
windows:
7882
@@ -87,7 +91,7 @@ cd ~/.WebpagePrinter
8791

8892
```
8993

90-
第一次运行时会生成默认的配置文件:
94+
默认的配置:
9195

9296
./config.ini
9397

@@ -100,7 +104,6 @@ local_websocket_server_port=8846
100104
remote_websocket_server_url_only_ws=
101105
102106
```
103-
104107
修改后重启生效.
105108

106109
一共有三种连接方式:
@@ -121,15 +124,17 @@ remote_websocket_server_url_only_ws=
121124

122125

123126
![](https://cloud.zerlei.cn/f/3lfW/Screenshot_20250913_005106.png)
124-
如同前台工具页面描述,你需要首先定义一个config. 指定打印机 纸张大小等.然后再根据config,去发出一个print 请求.
127+
如同前台工具页面描述,你需要首先定义一个config. 指定打印机 纸张大小等.然后再根据config,去发出一个print请求.
125128

126129
参考注释: 1.[config](https://wpp.zerlei.cn/structPrinterConfig) 2. [page](https://wpp.zerlei.cn/structPrintedPage)
127130

131+
> [!IMPORTANT]
132+
> [参考](https://wpp.zerlei.cn/structPrintedPage) `page_loaded_or_js_request` 字段. 如果选择使用`JS_REQUEST`,建议在js中使用原始的 `window.print()`.不同的js 打印库,实现方式不同,没有办法一一保证.
128133
129134

130-
无论使用任何一种连接方式,数据格式都是`json`,不同连接方式,相同意义请求,传递的内容一致.
135+
无论使用任何一种连接方式,数据格式都是`json`,不同连接方式,相同请求,传递的内容一致.
131136

132-
- http 统一使用 POST 请求,url `/command` **所有内容放在 body 中**
137+
- http 全部使用 POST 请求,url `/command` **所有内容放在 body 中**
133138

134139
example:
135140

@@ -206,7 +211,8 @@ struct RespError : RespBase {
206211
### 1.1 获得工具安装电脑上的打印机和纸张信息
207212

208213
此机器上,可以获取的打印机驱动.
209-
建议在[config](https://wpp.zerlei.cn/structPrinterConfig)中,设置is_use_printer_default_config = 1; 使用打印机默认配置
214+
215+
建议在[config](https://wpp.zerlei.cn/structPrinterConfig)中,设置is_use_printer_default_config = 1; 使用打印机默认配置,也就是在系统打印机配置页面,配置打印机
210216

211217
[参考](https://wpp.zerlei.cn/structRequestGetPrintersInfo)
212218

src/model/PrintedPage.h

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ struct PrintedPage {
2020
int config_id;
2121

2222
/**
23-
* @brief PAGE_LOADED or JS_REQUEST
23+
* @brief PAGE_LOADED(页面加载完毕) or JS_REQUEST(window.print()被调用)
2424
*
2525
*/
2626
QString page_loaded_or_js_request;
@@ -30,7 +30,7 @@ struct PrintedPage {
3030
*/
3131
QString time;
3232
/**
33-
* @brief 状态 ERROR OR STEP
33+
* @brief 状态 STEP
3434
*
3535
*/
3636
QString status;
@@ -45,7 +45,7 @@ struct PrintedPage {
4545
*/
4646
QString page_file_path;
4747
/**
48-
* @brief 打印的网页
48+
* @brief 打印的网页, 如果是磁盘上的文件,请添加 `file://`前缀
4949
*
5050
*/
5151
QString page_url;

0 commit comments

Comments
 (0)