# Html5 applications

This page is for uweb browser.
Click to install the following html5 apps:
Huge markdown file viewer
Huge markdown+katex file viewer (Tex formulas)
Huge markdeep file viewer (markdown, latex, diagram,graphviz etc.)
plyr video player
dplayer video player
pdf viewer
epub reader (author：llili)
djvu viewer

The corresponding menus can be installed with url services.

#### Features

The following mentioned subfolders locate in the configuration folder.

- The following html5 applications are allowed to read local files referred by "https://local/sdcard/..." where the "/sdcard/.." part is the full path of the file. The below applications can auto choose any files as file objects.

  - Locating in a subfolder whose name begins with "app" (such as "appPDF")
  - "https://local/..." applications (only possible with the option "use offline resources" and installed under the folder "sitecache/local/")

- All files under the subfolder "app" can be automatically choosed as file objects by any web page.

- Local files (including binary files) can be processed by appending "?app=[html5 app url]" to the file urls. Ex. "file:///..../xx.md?app=https://...../app.html" loads "app.html" first, then "app.html" processes the local file.

With the first approach, the html5 application is installed locally and can read any file allowed by the OS; while in the second approach, the html5 application can be either local or remote, and only files under the subfolder "app" can be accessed; The third approach allows easy access of other external resources (ex. local media).

#### Open local files with html5 apps

Click to configure default.filecap to open local files, and to open remote files with the option "custom file handling":
use pdf.js,djvu.js,epub.js, huge markdown viewer for local files

url examples are as follows:

- file:///data/user/0/info.torapp.uweb/files/app/pdfviewer.html?file=[path].pdf#page=[xxx]
- file:///data/user/0/info.torapp.uweb/files/app/djvu.html?url=...xx.pdf#page=[xxx]
- file:///data/user/0/info.torapp.uweb/files/app/txtview.html?url=[url]#page=[xxx]
- file:///data/user/0/info.torapp.uweb/files/app/txtview.html?url=[url]#offset=[xxxx]&[length]
- file:///data/user/0/info.torapp.uweb/files/app/markdeep.html?url=[url]#page=[xxx]
- file:///data/user/0/info.torapp.uweb/files/app/markdeep.html?url=[url]#offset=[xxxx]&[length]

Ex. "#offset=10000&500" will retrieve 500 bytes from offset 10000. Click the right arrow button to next page in all above file viewers.

#### Configure html5 app subfolder "app" (optional)

By default, the subfolder "app" is created by clicking to install any of above html5 applications.

To make file management easier, users can symbolic link the subfolder "app" to any other locations as long as it is readable.

One way to configure "app" subfolder is as follows:

- Click to copy the command to the address bar
- Press the home screen button of uweb browser bottom toolbar, so the home screen appears.
- If you want "app" to be locations other than "/sdcard/Download/app", modify as you like.
- Press "enter" on the address bar to execute the command.

#### mdict dictionary lookup search engines:

Note: the following two mdict.html files are different.
i:5ifile:///....../xxx.mdx,xxx.mdd?app=https://cdn.jsdelivr.net/gh/torappinfo/uweb/en/searchurl/mdict/mdict.html#word=%s

in which "/.../xxx.mdx,xxx.mdd" is the full path for the mdict dictionary files.

i:5ihttps://uwebzh.netlify.app/zh/searchurl/txt/mdict.html?file=mdict/xxx.mdx,mdict/xxx.mdd#word=%s

In the above mdict search engine string, the dictionary files (mdx, mdd) must locate in the "app" subfolder under the configuration folder. In above example, the files "xxx.mdx" and "xxx.mdd" locate in the folder ".../app/mdict".

To make life easier, users can link the "app" subfolder to any public accessible folder.

Use the mdx scanning bookmark to add mdict engines automatically, then cold start uweb browser to take effect.

Last Modified: 2 April 2024
add js function in README