diff options
authorBryce Kwon <bryce@brycekwon.com>
committerBryce Kwon <bryce@brycekwon.com>
commit
parent
tree
download
Check every markup hook the README names
The README promised that t0005 checked them all, while fourteen went unchecked, and three of its claims were too broad. A date shown in full carries no age hooks, line anchors follow enable-tree-linenumbers and cgit.css also styles html.cgit-standalone.
Diffstat (limited to 'README.txt')
-rw-r--r--README.txt19
1 file changed, 11 insertions, 8 deletions
diff --git a/README.txt b/README.txt
index 13b0971..37141d3 100644
--- a/README.txt
+++ b/README.txt
@@ -88,11 +88,14 @@ script added through the css and js options has stable hooks to work with.
table.commit-trailers, the diffstat is table.diffstat and each file of a diff
is div.file, or tbody.file in the side by side view, with the path in
data-path. The blob and blame pages open with div.blob-header.
-* Ages are time elements with an age-* class and the timestamp in data-ut. Line
- numbers are anchors named n followed by the line.
+* Relative ages are time elements with an age-* class and the timestamp in
+ data-ut, while a date shown in full is a plain time element. Line numbers are
+ anchors named n followed by the line, while enable-tree-linenumbers is on.
* Colours, fonts and metrics are custom properties on div#cgit, so a theme can
- redefine those alone. Every rule in cgit.css starts with div#cgit, and a rule
- of your own needs the same prefix to win.
+ redefine those alone. Every rule in cgit.css starts with div#cgit, apart from
+ the background and margins it sets on html.cgit-standalone, the class of the
+ document cgit writes when it is not embedded. A rule of your own needs the
+ div#cgit prefix to win.
* The script exposes window.cgit.updateAges and window.cgit.highlightLines for
a page that changes the rows or the lines after load.
@@ -192,10 +195,10 @@ feed rather than a page and accepts h, path and all. The clone endpoints under
info and objects implement the dumb HTTP protocol and are only present when http
clone is enabled.
-A url fragment can address lines inside a file. The tree and blame pages give
-every line an anchor named n followed by its number, so #n17 jumps to line 17
-and highlights it, and a range written #n17-n24 highlights the whole run and
-scrolls it into view.
+A url fragment can address lines inside a file. While enable-tree-linenumbers is
+on, as it is by default, the tree and blame pages give every line an anchor
+named n followed by its number, so #n17 jumps to line 17 and highlights it, and
+a range written #n17-n24 highlights the whole run and scrolls it into view.
Some worked examples, in the url= form.