mirror of
https://github.com/webrecorder/pywb.git
synced 2025-03-15 00:03:28 +01:00
613754307c
templates: - add placeholder footer.html, head.html templates - allow 'base_html', 'footer_html', 'head_html', 'header_html' to be added via wb-manager 'add-template' cmd - automatically add 'base.html' when adding a copy of other templates, as jinja2 extends looks for templates locally ui tweaks: - vueui: support logo loaded from ui.logo - make logo link to home page - home page: don't show collection title if title is empty documentation tweaks: - clarify static_path is for loading path - clarify footer and head templates are empty by default - remove extra is_framed from top frame template documentation bump to 2.7.0b1
95 lines
2.4 KiB
ReStructuredText
95 lines
2.4 KiB
ReStructuredText
.. _new-vue-ui:
|
|
|
|
|
|
New Vue-based UI (Alpha)
|
|
========================
|
|
|
|
With 2.7.0, pywb introduces a new `Vue UI <https://vuejs.org/>`_ based system, which can be enabled to provide a more feature-rich representation of a web archive.
|
|
|
|
The UI consists of two parts, which can be enabled using the ``ui`` block in ``config.yaml``
|
|
|
|
.. code:: yaml
|
|
|
|
ui:
|
|
vue_calendar_ui: true
|
|
vue_timeline_banner: true
|
|
|
|
|
|
Note: This UI is still in development and not all features are operational yet.
|
|
In particular, localization switching is not yet available in the alpha version.
|
|
|
|
Overview
|
|
--------
|
|
|
|
Calendar UI
|
|
^^^^^^^^^^^
|
|
|
|
The new calendar UI provides a histogram and a clickable calendar representation of a web archive.
|
|
|
|
The calendar is rendered in place of the standard URL query page.
|
|
|
|
.. image:: images/vue-cal.png
|
|
:width: 600
|
|
:alt: Calendar UI Screenshot
|
|
|
|
|
|
To enable this UI for URL query pages, set the ``ui.vue_calendar_ui`` property to true in the ``config.yaml``
|
|
|
|
|
|
Banner Replay UI
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
The new banner histogram allows for zooming in on captures per year as well as per month.
|
|
|
|
Navigation preserves the different levels. The full calendar UI is also available as a dropdown by clicking the calendar icon.
|
|
|
|
The new banner should allow for faster navigation across multiple captures.
|
|
|
|
.. image:: images/vue-banner.png
|
|
:width: 600
|
|
:alt: Calendar UI Screenshot
|
|
|
|
|
|
To enable this UI for replay pages, set the ``ui.vue_timeline_banner`` property to true in the ``config.yaml``
|
|
|
|
|
|
Custom Logo
|
|
^^^^^^^^^^^
|
|
|
|
When using the custom banner, it is possible to configure a logo by setting ``ui.logo`` to a static file.
|
|
|
|
If omitted, the standard pywb logo will be used by default.
|
|
|
|
If set, the logo should point to a file in the static directory (default is ``static`` but can be changed via the ``static_dir`` config option).
|
|
|
|
For example, to use the file ``./static/my-logo.png`` as the logo, set:
|
|
|
|
.. code:: yaml
|
|
|
|
ui:
|
|
logo: my-logo.png
|
|
|
|
|
|
Updating the Vue UI
|
|
-------------------
|
|
|
|
The UI is contained within the ``pywb/vueui`` directory.
|
|
|
|
The Vue component sources can be found in ``pywb/vueui/src``.
|
|
|
|
Updating the UI requires ``node`` and ``yarn``.
|
|
|
|
To install and build, run:
|
|
|
|
|
|
.. code:: console
|
|
|
|
cd pywb/vueui
|
|
yarn install
|
|
yarn build
|
|
|
|
|
|
This will generate the output to ``pywb/static/vue/vueui.js`` which is loaded from the default templates when the Vue UI rendering is enabled.
|
|
|
|
Additional styles for the banner are loaded from ``pywb/static/vue_banner.css``.
|