move ebrowser README together with package files

2024-08-14 23:54:59 +00:00 · 2024-06-24 10:43:03 +08:00 · 2024-06-24 10:43:03 +08:00 · 536ff07ffa
commit 536ff07ffa
parent d28fe3eed2
13 changed files with 137 additions and 21 deletions
--- a/README.md
+++ b/README.md
@ -41,7 +41,7 @@ Custom paper size PDF export and long vector screenshot, TTS, text reflow, resou
 ![](https://i.postimg.cc/XJ58ysdN/option1.png)
 ![](https://i.postimg.cc/0NFnQT6H/option2.png)

-#### <a href="ebrowser.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux
+#### <a href="misc/ebrowser/README.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux
 Ebrowser is a simple version of uweb browser on the desktop.
 - Fully open source.
 - Capture long screenshot as vector graphics. 
--- a/README.zh-Hans.md
+++ b/README.zh-Hans.md
@ -53,7 +53,7 @@

 配套安装uWeb定制Termux应用，可用地址栏作图（类似matlab功能）、超级计算器（无限精度/π的前万位或更多、无限函数、无限常量）、符号演算（解方程、分解因式、求积分导数）、离线字典查找等。譬如地址栏输入sin(x)**5就直接得到函数图形。利用好第三方代码，才能真正发挥出uWeb的潜能。

-#### <a href="ebrowser.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux
+#### <a href="misc/ebrowser/README.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux
 可看作超微浏览器台式机简易版，用于弥补普通浏览器访问痛点。
 - 支持网站自动镜像，可以使用国内镜像自动访问github等网站，可与国际搜索引擎无缝衔接。
 - 同样允许直接访问英文技术网站。
--- a/README.zh.md
+++ b/README.zh.md
@ -53,7 +53,7 @@

 配套安装uWeb定制Termux应用，可用地址栏作图（类似matlab功能）、超级计算器（无限精度/π的前万位或更多、无限函数、无限常量）、符号演算（解方程、分解因式、求积分导数）、离线字典查找等。譬如地址栏输入sin(x)**5就直接得到函数图形。利用好第三方代码，才能真正发挥出uWeb的潜能。

-#### <a href="ebrowser.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux
+#### <a href="misc/ebrowser/README.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux
 可看作超微浏览器台式机简易版，用于弥补普通浏览器访问痛点。
 - 支持网站自动镜像，可以使用国内镜像自动访问github等网站，可与国际搜索引擎无缝衔接。
 - 同样允许直接访问英文技术网站。
--- a/en/index.xml
+++ b/en/index.xml
@ -6,7 +6,7 @@
    <description>Recent content on uweb browser: unlimited power</description>
    <generator>Hugo</generator>
    <language>en</language>
-    <lastBuildDate>Mon, 24 Jun 2024 09:46:43 +0800</lastBuildDate>
+    <lastBuildDate>Mon, 24 Jun 2024 10:28:02 +0800</lastBuildDate>
    <atom:link href="/en/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>Text selection/processing</title>
--- a/en/readme/index.html
+++ b/en/readme/index.html
@ -88,7 +88,7 @@
 <img src="https://i.postimg.cc/HLV3TYLy/longclick.png"><br>
 <img src="https://i.postimg.cc/XJ58ysdN/option1.png"><br>
 <img src="https://i.postimg.cc/0NFnQT6H/option2.png"></p>
-<h4 id="a-hrefebrowsermd--onclickifnotrepolocationenebrowserreadmeindexhtmlreturn-falseebrowsera-for-windows-macos-and-linux"><a href="ebrowser.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux</h4>
+<h4 id="a-hrefmiscebrowserreadmemd--onclickifnotrepolocationenebrowserreadmeindexhtmlreturn-falseebrowsera-for-windows-macos-and-linux"><a href="misc/ebrowser/README.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux</h4>
 <p>Ebrowser is a simple version of uweb browser on the desktop.</p>
 <ul>
 <li>Fully open source.</li>
@ -106,8 +106,8 @@
 </ul>

 </div>
-<p>Last Modified: 18 June 2024<br>
-update mirrors<br>
+<p>Last Modified: 24 June 2024<br>
+move ebrowser README together with package files<br>
 <pre></pre>
 </p>

--- a/en/sitemap.xml
+++ b/en/sitemap.xml
@ -71,7 +71,7 @@
                />
  </url><url>
    <loc>/en/</loc>
-    <lastmod>2024-06-24T09:46:43+08:00</lastmod>
+    <lastmod>2024-06-24T10:28:02+08:00</lastmod>
    <xhtml:link
                rel="alternate"
                hreflang="zh"
@ -514,7 +514,7 @@
    <lastmod>2024-06-18T23:17:17+08:00</lastmod>
  </url><url>
    <loc>/en/readme/</loc>
-    <lastmod>2024-06-18T11:13:22+08:00</lastmod>
+    <lastmod>2024-06-24T10:28:02+08:00</lastmod>
    <xhtml:link
                rel="alternate"
                hreflang="zh"
@ -539,7 +539,7 @@
                />
  </url><url>
    <loc>/en/unlist/</loc>
-    <lastmod>2024-06-24T09:46:43+08:00</lastmod>
+    <lastmod>2024-06-24T10:28:02+08:00</lastmod>
    <xhtml:link
                rel="alternate"
                hreflang="zh"
--- a/misc/ebrowser/README.md
+++ b/misc/ebrowser/README.md
@ -0,0 +1,116 @@
+### [Ebrowser](https://github.com/torappinfo/ebrowser): keyboard-friendly minimal suckless web browser
+Ebrowser is designed with the philosophy of [Android uweb browser](https://github.com/torappinfo/uweb) ([gitlab](https://gitlab.com/jamesfengcao/uweb)).
+
+- lightweight (less than 20k bytes) without bundled electron.
+- much less memory footprint than edge/chrome browser and highly performant.
+- keyboard friendly with vim-style keymaps and command line support in address bar.
+- [global redirection](https://uweb.surge.sh/en/redirect/index.html#) to bypass censorship.
+- user scripts at will. Ex. pressing "tr" to translate the page (need mapkeys.json config).
+- customizable.
+
+Note: Usually electron apps are heavyweight as they use browsers for simple things. Ebrowser uses core chromium effectively and very lightweight. Recommend to install electron separately.
+
+#### Installing (for Windows, MacOS and Linux)
+##### Install with prebuilt binaries
+You can find prebuilt binaries [here](https://github.com/torappinfo/ebrowser/releases).
+
+##### Install with nodejs
+
+    npm install electron
+    npm install ebrowser
+
+Run ebrowser
+
+    electron ~/node_modules/ebrowser
+
+Later on, you can run "npm install electron" to update electron/chromium or "npm install ebrowser" to update ebrowser independently.
+
+##### Update app quickly without updating chromium
+Pressing "Alt" to show the menu bar and choose "Check for updates" under "Help". OR
+
+Type ":update" in the address bar and press "enter" key to update.
+
+Mirror urls could be used like ":update https://uwebzh.netlify.app/misc/ebrowser". All the mirrors listed on [uweb browser](https://uwebzh.netlify.app/en/readme/index.html) could be used. The update url needs to be changed accordingly to be the folder "misc/ebrowser" under the mirror site root url.
+
+#### Key shortcuts
+- CTRL+C: stop loading
+- CTRL+G: address bar to show page url
+- CTRL+L: focus to address bar
+- CTRL+T: new Tab
+- CTRL+SHIFT+T: restore closed Tab
+- CTRL+TAB: switch to next tab
+- CTRL+SHIFT+TAB: switch to previous tab
+- CTRL+W: close Tab
+- ALT+<-: go backward
+- ALT+->: go forward
+- CTRL+SHIFT+R: enable global redirection ("gredirect.json")
+- CTRL+R: disable global redirection
+- ESC: remove focus. similar to vi normal mode.
+- F1: Help
+- F5: page refresh/reload
+- F12: devtools
+
+#### Address bar commands
+- "/" for find-in-page
+- ":" for address bar commands
+  - ac [bookmark/history path w/o ext] : load ".rec" file for autocomplete.
+  - b [bookmarkfilename w/o ext] : bookmark current page in file.
+  - bml [filename w/o extension]: load/execute the javascript file.
+  - cert : allow invalid certificates w/o arguments, otherwise restore to default.
+  - clear : the arguments could be
+    - cache : clear cache
+    - dns : clear dns cache
+    - storage: clear site storage data.
+    - {[options](https://www.electronjs.org/docs/latest/api/session#sescleardataoptions)}
+  - ext [extension path]: load unpacked Chrome extension.
+  - gr [gredirect index]: global redirection with corresponding index. Use the first global redirection url if no argument. Disable global redirection with any index out of the range.
+  - js [js code] : execute JS code at OS level. Note: "javascript:..." is special url and thus works in the current web page, while ":js ..." commands can do any OS operations. 
+  - nc/uc : No Cookie forwarding/Use Cookie forwarding with global redirection.
+  - nh/uh for No/Use url history.
+  - nj/uj for No/Use external Javascript files.
+  - nr/ur for No/Use "redirect.json" for domain redirection.
+  - np : no proxy.
+  - up [proxyName] : use proxy. privous proxy or the first proxy in proxy.json w/o [proxyName]. ":up" command also disables global and domain redirections, which are not restored by ":np".
+  - ua [useragentName] : set user agent for future tabs. default user agent w/o arguments.
+  - update [updateurl] : update the app. updateurl is optional.
+  - pdf [filename w/o extension] {[options](https://www.electronjs.org/docs/latest/api/web-contents#contentsprinttopdfoptions)} : print to PDF file. All arguments are optional; empty option "{}" to capture long screenshot as vector graphics.
+- "!" address bar commands  
+  "!xx ..." evaluates "xx.js" with the whole text as arguments[0].
+  
+#### Commands in no-focus mode (this mode is similar to vi Normal mode)
+Pressing "ESC" to enter no-focus mode if not sure.
+- ":" for address bar commands
+- "/" for find-in-page with address bar
+- "!" for "!" address bar commands
+
+The other commands are defined in "mapkeys.json", which will map keys to address bar commands.
+
+#### Configuration files
+- "config": lines of address bar commands.
+- "search.json": search engines as shortcut-queryUrl pairs.
+- "default.autoc": predefined strings for address bar auto completion.
+- "gredirect.json": global redirection urls as array of urls
+- "redirect.json": domain-replacementDomain pairs, default to be applied.
+- "mapkeys.json": keys-addressbarCommands pairs. The addressbar commands are multiple lines of address bar command separated by "\n".
+- "proxy.json": name-[ProxyConfig](https://www.electronjs.org/docs/latest/api/structures/proxy-config) pairs
+- "uas.json" : name-useragent pairs
+
+#### Javascript at three levels
+- Web page: urls like "javascript:" or bookmarklet command ":bml" run in web page.
+- Browser (or renderer process) : "!xx" evaluates "xx.js", which could manipulate address bar etc.
+- OS level (or main process) : ":js" to execute the following js code with all OS APIs available.
+
+#### New usages
+- Vector designing with web tech to replace Adobe Illustrator/Inkscape.
+  - Design with web tech.
+  
+  - Printing to pdf with customized paper size.
+  - Magnify the pdf paper size to the required size.
+
+  OR
+  
+  - Adjust window width and use addressbar command line ":Pdf {}" to export vector graphics.
+  - Use imageMagick to convert to any other vector graphics format.
+
+#### License
+You can copy or modify the code/program under the terms of the GPL3.0 or later versions.
--- a/misc/ebrowser/package.json
+++ b/misc/ebrowser/package.json
@ -1,4 +1,4 @@
-{"version":"1.0.30",
+{"version":"1.0.31",
  "name": "ebrowser",
  "description": "The keyboard-friendly minimal suckless web browser",
  "main": "webview.js",
--- a/misc/ebrowser/webview.js
+++ b/misc/ebrowser/webview.js
@ -413,7 +413,7 @@ function topMenu(){
        { label: 'Redirect', accelerator: 'Ctrl+Shift+R', click: ()=>{
          gredirect_enable(0);
        }},
-        { label: 'Close', accelerator: 'Ctrl+W', click: ()=>{
+        { label: 'Close tab', accelerator: 'Ctrl+W', click: ()=>{
          win.webContents.executeJavaScript("tabClose()",false).then((r)=>{
            if(""===r) win.close();
            else win.setTitle(r);
--- a/sitemap.xml
+++ b/sitemap.xml
@ -4,14 +4,14 @@
  <sitemap>
    <loc>/en/sitemap.xml</loc>
    
-      <lastmod>2024-06-24T09:46:43+08:00</lastmod>
+      <lastmod>2024-06-24T10:28:02+08:00</lastmod>
    
  </sitemap>
  
  <sitemap>
    <loc>/zh/sitemap.xml</loc>
    
-      <lastmod>2024-06-18T08:06:18+08:00</lastmod>
+      <lastmod>2024-06-24T10:28:37+08:00</lastmod>
    
  </sitemap>
  
--- a/zh/index.xml
+++ b/zh/index.xml
@ -6,7 +6,7 @@
    <description>Recent content on 超微浏览器: 威、快、高效、极致优化</description>
    <generator>Hugo</generator>
    <language>zh</language>
-    <lastBuildDate>Tue, 18 Jun 2024 08:06:18 +0800</lastBuildDate>
+    <lastBuildDate>Mon, 24 Jun 2024 10:28:37 +0800</lastBuildDate>
    <atom:link href="/zh/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>操作选中（富）文本／元素</title>
--- a/zh/readme/index.html
+++ b/zh/readme/index.html
@ -90,7 +90,7 @@
 <p>支持网址特定脚本/样式，可轻松支持百万以上不同脚本。</p>
 <p>支持自定义任意多个搜索引擎; 支持执行用户提供任何js文件; 支持用户定义任意多个useragent; 长按链接支持运行第三方程序; 长按链接支持运行用户js文件。</p>
 <p>配套安装uWeb定制Termux应用，可用地址栏作图（类似matlab功能）、超级计算器（无限精度/π的前万位或更多、无限函数、无限常量）、符号演算（解方程、分解因式、求积分导数）、离线字典查找等。譬如地址栏输入sin(x)**5就直接得到函数图形。利用好第三方代码，才能真正发挥出uWeb的潜能。</p>
-<h4 id="a-hrefebrowsermd--onclickifnotrepolocationenebrowserreadmeindexhtmlreturn-falseebrowsera-for-windows-macos-and-linux"><a href="ebrowser.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux</h4>
+<h4 id="a-hrefmiscebrowserreadmemd--onclickifnotrepolocationenebrowserreadmeindexhtmlreturn-falseebrowsera-for-windows-macos-and-linux"><a href="misc/ebrowser/README.md"  onclick="if(notRepo()){location='../../en/ebrowserreadme/index.html#';return false;}">Ebrowser</a> for Windows, MacOS and Linux</h4>
 <p>可看作超微浏览器台式机简易版，用于弥补普通浏览器访问痛点。</p>
 <ul>
 <li>
@ -119,8 +119,8 @@
 </ul>

 </div>
-<p>Last Modified: 13 June 2024<br>
-markdown rjs to use marked<br>
+<p>Last Modified: 24 June 2024<br>
+move ebrowser README together with package files<br>
 <pre></pre>
 </p>

--- a/zh/sitemap.xml
+++ b/zh/sitemap.xml
@ -81,7 +81,7 @@
                />
  </url><url>
    <loc>/zh/</loc>
-    <lastmod>2024-06-18T08:06:18+08:00</lastmod>
+    <lastmod>2024-06-24T10:28:37+08:00</lastmod>
    <xhtml:link
                rel="alternate"
                hreflang="en"
@ -483,7 +483,7 @@
    <lastmod>2024-04-02T11:46:25+08:00</lastmod>
  </url><url>
    <loc>/zh/readme/</loc>
-    <lastmod>2024-06-13T08:05:27+08:00</lastmod>
+    <lastmod>2024-06-24T10:28:37+08:00</lastmod>
    <xhtml:link
                rel="alternate"
                hreflang="en"
@ -511,7 +511,7 @@
    <lastmod>2024-04-02T11:46:25+08:00</lastmod>
  </url><url>
    <loc>/zh/unlist/</loc>
-    <lastmod>2024-06-13T08:05:27+08:00</lastmod>
+    <lastmod>2024-06-24T10:28:37+08:00</lastmod>
    <xhtml:link
                rel="alternate"
                hreflang="en"