mirror of
https://github.com/kiwix/kiwix-js-pwa.git
synced 2025-09-09 12:19:46 -04:00
Formatting
Former-commit-id: 8adefcdb80cb74581975c6133af8cf996c41efec [formerly 6f2ff7e2379137885f7d5e4fd48b4d5027d6aea9 [formerly 62286669b3b4e745318c430a5189d8930ef33150]] Former-commit-id: d749e114571469441d506c474f509fb10e21593d Former-commit-id: 1a95ec7a9cb1d9ce6c733313a958deb583079377
This commit is contained in:
parent
fbd28420cd
commit
3d8a632aef
@ -457,37 +457,37 @@
|
|||||||
This app does its best to handle links to <b>special ZIM content</b>, like active (dynamic) content, embedded videos, downladable content (EPUBs, PDFs) and images, but not everything
|
This app does its best to handle links to <b>special ZIM content</b>, like active (dynamic) content, embedded videos, downladable content (EPUBs, PDFs) and images, but not everything
|
||||||
works smoothly with every option.
|
works smoothly with every option.
|
||||||
</p>
|
</p>
|
||||||
<p>The app can usually operate in two modes: 'JQuery' (which manipulates the content of the article) and 'ServiceWorker' (which tries to get out of the way and let the ZIM do its
|
<p>The app can usually operate in two modes: "JQuery" (which manipulates the content of the article) and "ServiceWorker" (which tries to get out of the way and let the ZIM do its
|
||||||
thing - see below under <a href="#expert">Expert settings</a> for a fuller explanation). Some contexts, like mobile or old browsers, only support JQuery mode. Desktop systems
|
thing - see below under <a href="#expert">Expert settings</a> for a fuller explanation). Some contexts, like mobile or old browsers, only support JQuery mode. Desktop systems
|
||||||
and modern browsers support both modes. <i>'JQuery' mode doesn't support active or dynamic content.</i> You will usually get an <b>'Active Content Warning'</b> popping up at the
|
and modern browsers support both modes. <b><i>"JQuery" mode doesn't support active or dynamic content.</i></b> You will usually get an <b>Active Content Warning</b> popping up at the
|
||||||
top of the landing page (Home) if you open a ZIM that requires you to switch to 'ServiceWorker' mode. If you can't switch, you can often still access content in these archives
|
top of the landing page (Home) if you open a ZIM that requires you to switch to "ServiceWorker" mode. If you can't switch, you can often still access content in these archives
|
||||||
by using title search or typing a space in title search to show the <a href="#zimIndex">ZIM Archive Index</a> (see above), but some things, especially any proprietary User Interface,
|
by using title search or typing a space in title search to show the <a href="#zimIndex">ZIM Archive Index</a> (see above), but some things, especially any proprietary User Interface,
|
||||||
won't work.
|
won't work.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
You can <b>download images</b> (as long as they haven't been inserted dynamically) by turning on the option <b>'Allow image manipulation'</b> in Configuration. Then you will be
|
You can <b>download images</b> (as long as they haven't been inserted dynamically) by turning on the option <b>Allow image manipulation</b> in Configuration. Then you will be
|
||||||
able to right-click an image and save it to disk or open it in a new tab (only tested in Wikimedia ZIMs). However, <i>this doesn't work in the UWP app</i>: instead, you can enable
|
able to right-click an image and save it to disk or open it in a new tab (only tested in Wikimedia ZIMs). However, <i>this doesn't work in the UWP app</i>: instead, you can enable
|
||||||
the <b>'Insert breakout link'</b> option, export the article to a new browser tab (by clicking the Breakout link), and then you will be able to manipulate images in the browser tab.
|
the <b>Insert breakout link</b> option, export the article to a new browser tab (by clicking the Breakout link), and then you will be able to manipulate images in the browser tab.
|
||||||
Please note that enabling Image manipulation or the Breakout link feature can interfere badly with some ZIMs that rely heavily on active content. So turn these options off if you are
|
Please note that enabling Image manipulation or the Breakout link feature can interfere badly with some ZIMs that rely heavily on active content. So turn these options off if you are
|
||||||
using such ZIMs.
|
using such ZIMs.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
You can <b>download EPUBs and PDFs</b>, e.g. from Gutenberg ZIMs, in 'JQuery' mode, but the proprietary User Interface doesn't work (use title search instead). In the UWP Desktop app
|
You can <b>download EPUBs and PDFs</b>, e.g. from Gutenberg ZIMs, in "JQuery" mode, but the proprietary User Interface doesn't work (use title search instead). In the UWP Desktop app
|
||||||
in 'ServiceWorker' mode, you need to enable the option <b>'Open ZIM links in new tab'</b> (or window) in Configuration to be able to download EPUBs and PDFs. This isn't necessary in
|
in "ServiceWorker" mode, you need to enable the option <b>Open ZIM links in new tab</b> (or window) in Configuration to be able to download EPUBs and PDFs. This isn't necessary in
|
||||||
'JQuery' mode or in the PWA/ Electron/ NWJS apps. In 'JQuery' mode, the app will offer to download videos so you can view them in a different application. This is useful if your system
|
"JQuery" mode or in the PWA/ Electron/ NWJS apps. In "JQuery" mode, the app will offer to download videos so you can view them in a different application. This is useful if your system
|
||||||
doesn't support the WebP video format (e.g. the mobile UWP app).
|
doesn't support the WebP video format (e.g. the mobile UWP app).
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
You can <b>open ZIM links in a new browsable tab (or window)</b> by setting the options in Configuration. Right-click (or double right-click if you set that option), ctrl-click, middle click
|
You can <b>open ZIM links in a new browsable tab (or window)</b> by setting the options in Configuration. Right-click (or double right-click if you set that option), ctrl-click, middle click
|
||||||
and long press should all work. Somne contexts (e.g. mobile) don't support this option, or it works badly or very slowly. For those contexts, use the <b>'Insert breakout link'</b> feature
|
and long press should all work. Somne contexts (e.g. mobile) don't support this option, or it works badly or very slowly. For those contexts, use the <b>Insert breakout link</b> feature
|
||||||
instead. With the Breakout link feature, the tab is non-browsable, but you can save the page to PDF or print it, etc., from that tab.
|
instead. With the Breakout link feature, the tab is non-browsable, but you can save the page to PDF or print it, etc., from that tab.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
Note that your browser's <b>popup blocker</b> may interfere with options that open new tabs or windows. When asked, enable popups always for the app (if you trust Kiwix), and then reload the app.
|
Note that your browser's <b>popup blocker</b> may interfere with options that open new tabs or windows. When asked, enable popups always for the app (if you trust Kiwix), and then reload the app.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
<b>PhET ZIMs:</b> These science and maths simulations only work in 'ServiceWorker' mode. There is currently a bug which causes the experiment/ simulation to be shifted by several pixels, making
|
<b>PhET ZIMs:</b> These science and maths simulations only work in "ServiceWorker" mode. There is currently a bug which causes the experiment/ simulation to be shifted by several pixels, making
|
||||||
it hard to click on the experiment's controls. WORKAROUND: Please switch the 'Hide toolbars while scrolling' option to 'never'. This eliminates the pixel shift. You may also have to use the title
|
it hard to click on the experiment's controls. WORKAROUND: Please switch the <b>Hide toolbars while scrolling</b> option to <b>never</b>. This eliminates the pixel shift. You may also have to use the title
|
||||||
search or <a href="#zimIndex">ZIM Archive Index</a> (press a space in title seaarch) to find the experiments, as there is an unresolved issue with displaying the ZIM's User Interface.
|
search or <a href="#zimIndex">ZIM Archive Index</a> (press a space in title seaarch) to find the experiments, as there is an unresolved issue with displaying the ZIM's User Interface.
|
||||||
</p>
|
</p>
|
||||||
<p>
|
<p>
|
||||||
|
Loading…
x
Reference in New Issue
Block a user