Upgrading pagedjs: Difference between revisions

From Creative Crowds wiki
Jump to navigation Jump to search
Created page with "Up until today (February 21st, 2026), the version of pagedjs that Octomode depends on is 0.1.43. From today, we will upgrade the version to the latest stable version, 0.4.3. Octomode depends on two files that should be changed with the upgrade. * /opt/octomode/static/pagedjs.polyfill.js (v0.1.43) * /opt/octomode/static/pagedjs.css (v0.2.0) These should be upgraded to * /opt/octomode/static/pagedjs.polyfill.js (v0.4.3) * /opt/octomode/static/interface.css (v0.4) Th..."
 
Line 31: Line 31:


<code>
<code>
<nowiki>
<!DOCTYPE html>
<!DOCTYPE html>
<html lang="{{ lang }}">
<html lang="{{ lang }}">
Line 46: Line 47:
</body>
</body>
</html>
</html>
</nowiki>
</code>
</code>


Line 51: Line 53:


<code>
<code>
<nowiki>
<!DOCTYPE html>
<!DOCTYPE html>
<html lang="{{ lang }}">
<html lang="{{ lang }}">
Line 66: Line 69:
</body>
</body>
</html>
</html>
</nowiki>
</code>
</code>


TODO: upgrade pagedjs for wiki-to-print, which is a separate installation of pagedjs.
TODO: upgrade pagedjs for wiki-to-print, which is a separate installation of pagedjs.

Revision as of 14:04, 21 February 2026

Up until today (February 21st, 2026), the version of pagedjs that Octomode depends on is 0.1.43.

From today, we will upgrade the version to the latest stable version, 0.4.3.

Octomode depends on two files that should be changed with the upgrade.

  • /opt/octomode/static/pagedjs.polyfill.js (v0.1.43)
  • /opt/octomode/static/pagedjs.css (v0.2.0)

These should be upgraded to

  • /opt/octomode/static/pagedjs.polyfill.js (v0.4.3)
  • /opt/octomode/static/interface.css (v0.4)

The file pagedjs.polyfill.js can be overwritten, but as the CSS has a different filename, we should also update any templates that are being used by Octomode:

  • /opt/octomode/static/templates/pagedjs.html

Method

inside /opt/octomode/static/

$ curl https://app.unpkg.com/pagedjs@0.4.3/files/dist/paged.polyfill.js > pagedjs.polyfill.js $ curl https://gitlab.coko.foundation/pagedjs/interface-polyfill/-/raw/master/interface.css?ref_type=heads > interface.css

inside /opt/octomode/static/templates

$ sudo nano pagedjs.html

Replace the text "pagedjs.css" with "interface.css". Changing it from:

<!DOCTYPE html> <html lang="{{ lang }}"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <script src="{{ url_for('static', filename='paged.polyfill.js') }}" type="text/javascript"></script> <link href="{{ url_for('static', filename='pagedjs.css') }}" rel="stylesheet" type="text/css" media="screen"> <!-- [LOCAL HACK] mb: added /octomode/ below to make the stylesheet link work again. --> <link href="/octomode/{{ name }}/stylesheet.css" rel="stylesheet" type="text/css" media="print"> <title>{{ title }}</title> </head> <body> {{ pad_content }} </body> </html>

to

<!DOCTYPE html> <html lang="{{ lang }}"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <script src="{{ url_for('static', filename='paged.polyfill.js') }}" type="text/javascript"></script> <link href="{{ url_for('static', filename='interface.css') }}" rel="stylesheet" type="text/css" media="screen"> <!-- [LOCAL HACK] mb: added /octomode/ below to make the stylesheet link work again. --> <link href="/octomode/{{ name }}/stylesheet.css" rel="stylesheet" type="text/css" media="print"> <title>{{ title }}</title> </head> <body> {{ pad_content }} </body> </html>

TODO: upgrade pagedjs for wiki-to-print, which is a separate installation of pagedjs.