更新文档

This commit is contained in:
Tw93
2022-11-19 23:26:06 +08:00
parent df361cbbff
commit 68eb1438e2
2 changed files with 49 additions and 47 deletions

View File

@@ -14,7 +14,7 @@
<a href="https://github.com/tw93/Pake/issues?q=is%3Aissue+is%3Aclosed" target="_blank"> <a href="https://github.com/tw93/Pake/issues?q=is%3Aissue+is%3Aclosed" target="_blank">
<img alt="GitHub closed issues" src="https://img.shields.io/github/issues-closed/tw93/Pake.svg?style=flat-square"></a> <img alt="GitHub closed issues" src="https://img.shields.io/github/issues-closed/tw93/Pake.svg?style=flat-square"></a>
</div> </div>
<div align="left">很简单用 Rust 打包网页生成很小的 Mac App支持 微信读书、Twitter、Youtube、Flomo、Reference、RunCode、Google Translate、语雀、Witeboard、Vercel、V2EX、开发工具箱等欢迎去 <a href=https://github.com/tw93/Pake/discussions>讨论区</a> 交流分享。</div> <div align="left">很简单用 Rust 打包网页生成很小的桌面 App支持 Mac/Windows/Linux 应用,当前已打包微信读书、Twitter、Youtube、Flomo、Reference、RunCode、Google Translate、语雀、Witeboard、Vercel、V2EX、开发工具箱等欢迎去 <a href=https://github.com/tw93/Pake/discussions>讨论区</a> 交流分享。</div>
</p> </p>
## 特征 ## 特征
@@ -63,19 +63,8 @@
更多常用 App 下载可以去 [Releases](https://github.com/tw93/Pake/releases) 中看看。 更多常用 App 下载可以去 [Releases](https://github.com/tw93/Pake/releases) 中看看。
## 快捷键(Windows/Linux)
1. <kbd>Ctrl</kbd> + <kbd>⬅</kbd>:返回上一个页面
2. <kbd>Ctrl</kbd> + <kbd>➡</kbd>:去下一个页面
3. <kbd>Ctrl</kbd> + <kbd>⬆</kbd>:自动滚动到页面顶部
4. <kbd>Ctrl</kbd> + <kbd>⬇</kbd>:自动滚动到页面底部
5. <kbd>Ctrl</kbd> + <kbd>r</kbd>:刷新页面
6. <kbd>Ctrl</kbd> + <kbd>-</kbd>:缩小页面
7. <kbd>Ctrl</kbd> + <kbd>+</kbd>:放大页面
8. <kbd>Ctrl</kbd> + <kbd>=</kbd>:放大页面
9. <kbd>Ctrl</kbd> + <kbd>0</kbd>:重置页面缩放
## 快捷键(Mac) ## 快捷键(Mac)
1. <kbd>⌘</kbd> + <kbd>[</kbd>:返回上一个页面 1. <kbd>⌘</kbd> + <kbd>[</kbd>:返回上一个页面
2. <kbd>⌘</kbd> + <kbd>]</kbd>:去下一个页面 2. <kbd>⌘</kbd> + <kbd>]</kbd>:去下一个页面
3. <kbd>⌘</kbd> + <kbd>↑</kbd>:自动滚动到页面顶部 3. <kbd>⌘</kbd> + <kbd>↑</kbd>:自动滚动到页面顶部
@@ -86,15 +75,28 @@
8. <kbd>⌘</kbd> + <kbd>=</kbd>:放大页面 8. <kbd>⌘</kbd> + <kbd>=</kbd>:放大页面
9. <kbd>⌘</kbd> + <kbd>0</kbd>:重置页面缩放 9. <kbd>⌘</kbd> + <kbd>0</kbd>:重置页面缩放
## 快捷键(Windows/Linux)
1. <kbd>Ctrl</kbd> + <kbd>←</kbd>:返回上一个页面
2. <kbd>Ctrl</kbd> + <kbd>→</kbd>:去下一个页面
3. <kbd>Ctrl</kbd> + <kbd>↑</kbd>:自动滚动到页面顶部
4. <kbd>Ctrl</kbd> + <kbd>↓</kbd>:自动滚动到页面底部
5. <kbd>Ctrl</kbd> + <kbd>r</kbd>:刷新页面
6. <kbd>Ctrl</kbd> + <kbd>-</kbd>:缩小页面
7. <kbd>Ctrl</kbd> + <kbd>+</kbd>:放大页面
8. <kbd>Ctrl</kbd> + <kbd>=</kbd>:放大页面
9. <kbd>Ctrl</kbd> + <kbd>0</kbd>:重置页面缩放
此外还支持双击头部进行全屏切换,拖拽头部进行移动窗口,还有其他需求,欢迎提过来。 此外还支持双击头部进行全屏切换,拖拽头部进行移动窗口,还有其他需求,欢迎提过来。
## 已知Bug ## 待解决问题
- Windows下不能安装到C:\Program File会直接闪退。建议安装到其他目录比如D:\Program Files。
- Linux下暂时不能存cookie即应用关闭后数据清空账号自动推出 - Windows 下不能安装到 C:\Program File会直接闪退。建议安装到其他目录比如 D:\Program Files
- Linux 下暂时不能存 cookie即应用关闭后数据清空账号自动推出。
## 开发 ## 开发
开始前参考 [Tauri](https://tauri.app/v1/guides/getting-started/prerequisites#setting-up-macos) 快速配置好环境,如果你想打包 Windows、Linux 系统的包,可以参考 [Building](https://tauri.app/v1/guides/building/) 文档 开始前参考 [Tauri](https://tauri.app/v1/guides/getting-started/prerequisites#setting-up-macos) 快速配置好环境
```sh ```sh
// 安装依赖 // 安装依赖
@@ -103,26 +105,26 @@ npm i
// 调试 // 调试
npm run dev npm run dev
// 打包(Mac) // 打包 Mac 应用
npm run build npm run build
// 打包Windows // 打包 Windows 应用
npm run build:windows npm run build:windows
// 打包Linux // 打包 Linux 应用
npm run build:linux npm run build:linux
// 一键打包所有项目Linux/Mac // 一键打包所有 Mac/Linux 应用
chmod +x build.sh && ./build.sh chmod +x build.sh && ./build.sh
// 一键打包所有项目(Windows) // 一键打包所有 Windows 项目
.\build.bat .\build.bat
``` ```
## 打新包 ## 打新包
1. 修改 `src-tauri` 目录下的 `tauri.conf.json` 中的 `url、productName、icon、identifier` 这 4 个字段,其中 icon 可以从 icons 目录选择一个,也可以去 [macOSicons](https://macosicons.com/#/) 下载符合产品名称的 1. 修改 `src-tauri` 目录下的 `tauri.conf.json` 中的 `url、productName、icon、identifier` 这 4 个字段,其中 icon 可以从 icons 目录选择一个,也可以去 [macOSicons](https://macosicons.com/#/) 下载符合产品名称的
2. 关于窗口属性设置,可以在 `tauri.conf.json` 修改 `windows` 属性对应的 `width/height`,是否全屏 `fullscreen`,是否可以调整大小 `resizable`,假如想适配沉浸式头部,可以将 `transparent` 设置成 `true`,找到 Header 元素加一个 `padding-top` 样式即可,不想适配改成 `false` 也行 2. 关于窗口属性设置,可以在 `tauri.conf.json` 修改 `windows` 属性对应的 `width/height`,是否全屏 `fullscreen`,是否可以调整大小 `resizable`,假如想适配 Mac 沉浸式头部,可以将 `transparent` 设置成 `true`,找到 Header 元素加一个 `padding-top` 样式即可,不想适配改成 `false` 也行
3. `npm run dev` 本地调试看看效果,此外可以使用 `npm run dev:debug` 进行容器调试 3. `npm run dev` 本地调试看看效果,此外可以使用 `npm run dev:debug` 进行容器调试
4. `npm run build` 运行即可打生产包 4. `npm run build` 运行即可打生产包
@@ -235,4 +237,4 @@ chmod +x build.sh && ./build.sh
## 最后 ## 最后
1. 希望大伙玩的过程中有一种学习新技术的喜悦感,如果有新点子欢迎告诉我 1. 希望大伙玩的过程中有一种学习新技术的喜悦感,如果有新点子欢迎告诉我
2. 假如你发现有很适合做成 Mac App 的网页也很欢迎告诉我,我给加到里面来 2. 假如你发现有很适合做成桌面 App 的网页也很欢迎告诉我,我给加到里面来

View File

@@ -14,7 +14,7 @@
<a href="https://github.com/tw93/Pake/issues?q=is%3Aissue+is%3Aclosed" target="_blank"> <a href="https://github.com/tw93/Pake/issues?q=is%3Aissue+is%3Aclosed" target="_blank">
<img alt="GitHub closed issues" src="https://img.shields.io/github/issues-closed/tw93/Pake.svg?style=flat-square"></a> <img alt="GitHub closed issues" src="https://img.shields.io/github/issues-closed/tw93/Pake.svg?style=flat-square"></a>
</div> </div>
<div align="left">A simple way to package a web page to Mac App, supporting WeRead、Twitter、Youtube、Reference、Flomo、YuQue、Google Translate、Witeboard、RunCode、Vercel、V2EX、DevTools, welcome to <a href=https://github.com/tw93/Pake/discussions>Discussions</a> to see if there have anything you interesting.</div> <div align="left">A simple way to package a web page to desktop application, supporting Mac/Windows/Linux, now has packaging WeRead、Twitter、Youtube、Reference、Flomo、YuQue、Google Translate、Witeboard、RunCode、Vercel、V2EX、DevTools, welcome to <a href=https://github.com/tw93/Pake/discussions>Discussions</a> to see if there have anything you interesting.</div>
</p> </p>
## Features ## Features
@@ -63,20 +63,7 @@
More common apps can be downloaded from [Releases](https://github.com/tw93/Pake/releases). More common apps can be downloaded from [Releases](https://github.com/tw93/Pake/releases).
## Mac Shortcuts
## Shortcuts(Windows/Linux)
1. <kbd>Ctrl</kbd> + <kbd>⬅</kbd>Return to the previous page
2. <kbd>Ctrl</kbd> + <kbd>➡</kbd>Go to the next page
3. <kbd>Ctrl</kbd> + <kbd>⬆</kbd>Auto scroll to top of page
4. <kbd>Ctrl</kbd> + <kbd>⬇</kbd>Auto scroll to bottom of page
5. <kbd>Ctrl</kbd> + <kbd>r</kbd>Refresh Page
6. <kbd>Ctrl</kbd> + <kbd>-</kbd>Zoom out the page
7. <kbd>Ctrl</kbd> + <kbd>+</kbd>Zoom in the Page
8. <kbd>Ctrl</kbd> + <kbd>=</kbd>Zoom in the Page
9. <kbd>Ctrl</kbd> + <kbd>0</kbd>Reset the page zoom
## Shortcuts(Mac)
1. <kbd>⌘</kbd> + <kbd>[</kbd>Return to the previous page 1. <kbd>⌘</kbd> + <kbd>[</kbd>Return to the previous page
2. <kbd>⌘</kbd> + <kbd>]</kbd>Go to the next page 2. <kbd>⌘</kbd> + <kbd>]</kbd>Go to the next page
@@ -88,15 +75,28 @@ More common apps can be downloaded from [Releases](https://github.com/tw93/Pake/
8. <kbd>⌘</kbd> + <kbd>=</kbd>Zoom in the Page 8. <kbd>⌘</kbd> + <kbd>=</kbd>Zoom in the Page
9. <kbd>⌘</kbd> + <kbd>0</kbd>Reset the page zoom 9. <kbd>⌘</kbd> + <kbd>0</kbd>Reset the page zoom
## Windows/Linux Shortcuts
1. <kbd>Ctrl</kbd> + <kbd>←</kbd>Return to the previous page
2. <kbd>Ctrl</kbd> + <kbd>→</kbd>Go to the next page
3. <kbd>Ctrl</kbd> + <kbd>↑</kbd>Auto scroll to top of page
4. <kbd>Ctrl</kbd> + <kbd>↓</kbd>Auto scroll to bottom of page
5. <kbd>Ctrl</kbd> + <kbd>r</kbd>Refresh Page
6. <kbd>Ctrl</kbd> + <kbd>-</kbd>Zoom out the page
7. <kbd>Ctrl</kbd> + <kbd>+</kbd>Zoom in the Page
8. <kbd>Ctrl</kbd> + <kbd>=</kbd>Zoom in the Page
9. <kbd>Ctrl</kbd> + <kbd>0</kbd>Reset the page zoom
In addition, it supports double clicking the head to switch to full screen, and dragging the head to move the window In addition, it supports double clicking the head to switch to full screen, and dragging the head to move the window
## Bugs ## Current issues
- It cannot be installed to C:\Program File under Windows, and it will crash directly. It is recommended to install to another directory, such as D:\Program Files. - It cannot be installed to C:\Program File under Windows, and it will crash directly. It is recommended to install to another directory, such as D:\Program Files.
- Under Linux, cookies cannot be stored temporarily, that is, the data will be cleared after the application is closed, and the account will be automatically released. - Under Linux, cookies cannot be stored temporarily, that is, the data will be cleared after the application is closed, and the account will be automatically released.
## Development ## Development
Refer to the [Tauri documentation](https://tauri.app/v1/guides/getting-started/prerequisites#setting-up-macos) to quickly configure your environment before you start, if you want to package Windows or Linux systems, you can refer to [Building](https://tauri.app/v1/guides/building/) Documentation. Refer to the [Tauri documentation](https://tauri.app/v1/guides/getting-started/prerequisites#setting-up-macos) to quickly configure your environment before you start.
```sh ```sh
// Install Dependencies // Install Dependencies
@@ -105,19 +105,19 @@ npm i
// Local development // Local development
npm run dev npm run dev
// Pack (Mac) // Pack Mac application
npm run build npm run build
// Pack (Windows) // Pack Windows application
npm run build:windows npm run build:windows
// Pack(Linux) // Pack Linux application
npm run build:linux npm run build:linux
// One-click packaging of all projects (Linux/Mac) // One-click packaging of all Linux/Mac projects
chmod +x build.sh && ./build.sh chmod +x build.sh && ./build.sh
// One-click packaging of all projects (Windows) // One-click packaging of all Windows projects
.\build.bat .\build.bat
``` ```
@@ -127,7 +127,7 @@ chmod +x build.sh && ./build.sh
## New pack ## New pack
1. Modify the `tauri.conf.json` in the `src-tauri` directory to include 4 fields `url, productName, icon, identifier`, icon can be selected from the `icons` directory or downloaded from [macOSicons](https://macosicons.com/#/) to match the product. 1. Modify the `tauri.conf.json` in the `src-tauri` directory to include 4 fields `url, productName, icon, identifier`, icon can be selected from the `icons` directory or downloaded from [macOSicons](https://macosicons.com/#/) to match the product.
2. For window property settings, you can modify the `width/height` of the `windows` property in `tauri.conf.json`, whether it is `fullscreen`, whether it is `resizable`, If you want to adapt the immersive header, you can set `transparent` to `true` and then find header element and add the `padding-top` style. 2. For window property settings, you can modify the `width/height` of the `windows` property in `tauri.conf.json`, whether it is `fullscreen`, whether it is `resizable`, If you want to adapt the immersive header under Mac, you can set `transparent` to `true` and then find header element and add the `padding-top` style.
3. `npm run dev` for local debugging; `npm run dev:debug` to open the devtools for container debugging. 3. `npm run dev` for local debugging; `npm run dev:debug` to open the devtools for container debugging.
4. `npm run build` can be run to package for production. 4. `npm run build` can be run to package for production.