From 29e068a7e8f5777dc0486e32738f8a6942bb6e21 Mon Sep 17 00:00:00 2001 From: Stephen Finucane Date: Fri, 9 Jun 2017 18:17:55 +0100 Subject: docs: Document the various htdocs supported Signed-off-by: Stephen Finucane --- htdocs/README.rst | 123 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 123 insertions(+) create mode 100644 htdocs/README.rst (limited to 'htdocs') diff --git a/htdocs/README.rst b/htdocs/README.rst new file mode 100644 index 0000000..513fb24 --- /dev/null +++ b/htdocs/README.rst @@ -0,0 +1,123 @@ +Static Assets +============= + +This directory contains the static assets used by Patchwork. Many of these are +third-party, though there are some are custom assets in there. + +.. _css: + +css +--- + +``bootstrap.min.css`` + + CSS for the `Bootstrap` library. + + Refer to the :ref:`js` section below for more information on `Bootstrap`. + +``selectize.bootstrap3.css`` + + CSS for the `Selectize` library. + + Refer to the :ref:`js` section below for more information on `Selectize`. + +``style.css`` + + Custom, Patchwork styling. Mostly a collection of overrides for default + Bootstrap styles. + + Part of Patchwork. + +.. _fonts: + +fonts +----- + +``glyphicons-halflings-regular.*`` + + Library of precisely prepared monochromatic icons and symbols, created with + an emphasis to simplicity and easy orientation. Provided as part of the + Bootstrap library. + + These are in multiple formats to support different browsers/environments. + Refer to the :ref:`js` section below for more information on Bootstrap. + +.. _js: + +js +-- + +``bootstrap.js`` + + The most popular HTML, CSS, and JavaScript framework for developing + responsive, mobile first projects on the web. + + This is used for the main UI of Patchwork. + + :Website: https://getbootstrap.com/ + :GitHub: https://github.com/twbs/bootstrap/ + :Version: 3.2.0 + +``bundle.js`` + + Utility functions for bundle patch list manipulation (re-ordering patches, + etc.) + + Part of Patchwork. + +``jquery.js`` + + jQuery is a fast, small, and feature-rich JavaScript library. It makes things + like HTML document traversal and manipulation, event handling, animation, and + Ajax much simpler with an easy-to-use API that works across a multitude of + browsers. With a combination of versatility and extensibility, jQuery has + changed the way that millions of people write JavaScript. + + This is used across Patchwork, including by the likes of ``bundle.js``, as + well as by the various plugins below. + + :Website: https://jquery.com/ + :GitHub: https://github.com/jquery/jquery + :Version: 1.10.1 + +``jquery.checkboxes.js`` + + A jQuery plugin that gives you nice powers over your checkboxes. + + This is used to allow shift-select of checkboxes on the patch list page. + + :Website: http://rmariuzzo.github.io/checkboxes.js + :GitHub: https://github.com/rmariuzzo/checkboxes.js + :Version: 1.0.6 + +``jquery.stickytableheaders.js`` + + A jQuery plugin that makes large tables more usable by having the table + header stick to the top of the screen when scrolling. + + This is used to ensure the heads on the patch list page stay at the top as we + scroll. + + :GitHub: https://github.com/jmosbech/StickyTableHeaders + :Version: 0.1.19 + +``jquery.tablednd.js`` + + jQuery plug-in to drag and drop rows in HTML tables. + + This is used by the bundle patch list to allow us to control the order of the + patches in said bundle. + + :Website: http://www.isocra.com/2008/02/table-drag-and-drop-jquery-plugin/ + :GitHub: jQuery plug-in to drag and drop rows in HTML tables + :Version: ??? + +``selectize.min.js`` + + Selectize is the hybrid of a ``textbox`` and ``