From f231807e381aa4987bcc7f11ddb29ea0165de43c Mon Sep 17 00:00:00 2001 From: Bryce Kwon Date: Wed, 4 Nov 2026 18:30:35 -1000 Subject: Say what an embedding page has to supply --- MANUAL.txt | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) (limited to 'MANUAL.txt') diff --git a/MANUAL.txt b/MANUAL.txt index 1b127e5..5cd9e91 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -169,8 +169,15 @@ email-filter:: embedded:: Flag which, when set to "1", makes cgit generate an HTML fragment - suitable for embedding in other HTML pages. Default value: "0". See - also: "enable-header". + suitable for embedding in other HTML pages. cgit then writes no document + head, so css, js, favicon, robots and head-include have no effect. The + host page, or the header and footer files around the fragment, has to + link cgit.css itself, load cgit.js with defer, and carry a robots meta + tag if one is wanted. cgit.css gives the fragment its own background and + colour scheme, which follows the visitor's light or dark preference + whatever the host page does, so a host page that is always light can pin + it with the rule div#cgit.cgit-embedded { color-scheme: light; }. + Default value: "0". See also: "enable-header". enable-blame:: Flag which, when set to "1", lets cgit provide a "blame" page for files -- cgit 2.12.1