qbit/nixpkgs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
dadc7eb329
nixpkgs/doc/Makefile

113 lines
3.3 KiB
Makefile
Raw Normal View History

docs: Build with a makefile
2018-03-24 09:36:10 -06:00
MD_TARGETS=$(addsuffix .xml, $(basename $(wildcard ./*.md ./**/*.md)))
.PHONY: all
nixpkgs doc: add format Make target
2018-04-30 20:35:54 -06:00
all: validate format out/html/index.html out/epub/manual.epub
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
Add 'make debug' to call xmloscopy
2018-03-25 18:01:31 -06:00
.PHONY: debug
debug:
nix-shell --run "xmloscopy --docbook5 ./manual.xml ./manual-full.xml"
nixpkgs docs: syntax highlight
2018-03-26 06:24:27 -06:00
nixpkgs doc: add format Make target
2018-04-30 20:35:54 -06:00
.PHONY: format
format:
manual: document ways of obtaining source hashes ... and security nuances
2019-01-10 14:15:23 -07:00
find . -iname '*.xml' -type f | while read f; do \
echo $$f ;\
xmlformat --config-file "$$XMLFORMAT_CONFIG" -i $$f ;\
done
nixpkgs doc: add format Make target
2018-04-30 20:35:54 -06:00
doc: Adds xml fixing script. (see previous and next commits) This script is used to automatically fix issues within xml documentation files. The script is *for now* intended to be used ad-hoc, and the commits to be examined. A future discussion will define whether: * This commit and scripts are kept. * The script is extended for common use. The biggest issue right now with the script is that it *could* in theory destroy a valid space-less varlistentry. The script could, in practical use, be changed and extended to normalize some parts of the XML files, mainly: * A common quoting style for attributes * Fix-up some weird formatting automatically that xmlformat doesn't catch
2018-05-31 18:26:27 -06:00
.PHONY: fix-misc-xml
fix-misc-xml:
find . -iname '*.xml' -type f \
-exec ../nixos/doc/varlistentry-fixer.rb {} ';'
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
.PHONY: clean
clean:
doc: Include function doc generation in Makefile Since #53055 was merged the Makefile for the manual could not be run correctly as the generated function documentation was included, but not actually generated. This adds the necessary generation step by first building the XML file containing function locations and preserving its store path in a variable, which is then used both for linking of the locations file and as a build input for the function docs generator. This fixes #55014
2019-02-01 03:45:30 -07:00
rm -f ${MD_TARGETS} .version manual-full.xml functions/library/locations.xml functions/library/generated
nixpkgs docs: syntax highlight
2018-03-26 06:24:27 -06:00
rm -rf ./out/ ./highlightjs
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
Move validate to top-level so it doesn't rebuild the outputs every time
2018-03-25 05:37:41 -06:00
.PHONY: validate
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
validate: manual-full.xml
jing "$$RNG" manual-full.xml
nixpkgs docs: syntax highlight
2018-03-26 06:24:27 -06:00
out/html/index.html: manual-full.xml style.css highlightjs
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
mkdir -p out/html
nixpkgs docs: Use SVGs for callouts
2018-03-26 12:04:19 -06:00
xsltproc ${xsltFlags} \
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
--nonet --xinclude \
--output $@ \
"$$XSL/docbook/xhtml/docbook.xsl" \
./manual-full.xml
nixpkgs docs: syntax highlight
2018-03-26 06:24:27 -06:00
mkdir -p out/html/highlightjs/
cp -r highlightjs out/html/
Move the overridden CSS to overrides.css which can be applied on nixos.org
2018-03-26 12:45:00 -06:00
cp ./overrides.css out/html/
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
cp ./style.css out/html/style.css
mkdir -p out/html/images/callouts
nixpkgs docs: Use SVGs for callouts
2018-03-26 12:04:19 -06:00
cp "$$XSL/docbook/images/callouts/"*.svg out/html/images/callouts/
nixpkgs docs: syntax highlight
2018-03-26 06:24:27 -06:00
chmod u+w -R out/html/
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
Move validate to top-level so it doesn't rebuild the outputs every time
2018-03-25 05:37:41 -06:00
out/epub/manual.epub: manual-full.xml
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
mkdir -p out/epub/scratch
nixpkgs docs: Use SVGs for callouts
2018-03-26 12:04:19 -06:00
xsltproc ${xsltFlags} --nonet \
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
--output out/epub/scratch/ \
"$$XSL/docbook/epub/docbook.xsl" \
./manual-full.xml
Move the overridden CSS to overrides.css which can be applied on nixos.org
2018-03-26 12:45:00 -06:00
cp ./overrides.css out/epub/scratch/OEBPS
nixpkgs docs: Use SVGs for callouts
2018-03-26 12:04:19 -06:00
cp ./style.css out/epub/scratch/OEBPS
mkdir -p out/epub/scratch/OEBPS/images/callouts/
cp "$$XSL/docbook/images/callouts/"*.svg out/epub/scratch/OEBPS/images/callouts/
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
echo "application/epub+zip" > mimetype
zip -0Xq "out/epub/manual.epub" mimetype
rm mimetype
cd "out/epub/scratch/" && zip -Xr9D "../manual.epub" *
rm -rf "out/epub/scratch/"
nixpkgs docs: syntax highlight
2018-03-26 06:24:27 -06:00
highlightjs:
mkdir -p highlightjs
cp -r "$$HIGHLIGHTJS/highlight.pack.js" highlightjs/
cp -r "$$HIGHLIGHTJS/LICENSE" highlightjs/
cp -r "$$HIGHLIGHTJS/mono-blue.css" highlightjs/
nixos docs: syntax highlight - Rectifies diverging CSS by combining nixos/nixpkgs docs CSS - Moves our custom Highlight.js loader in to the hljs package - Switches the nixos docs to use SVG callouts too
2018-04-05 05:54:01 -06:00
cp -r "$$HIGHLIGHTJS/loader.js" highlightjs/
nixpkgs docs: syntax highlight
2018-03-26 06:24:27 -06:00
doc: Include function doc generation in Makefile Since #53055 was merged the Makefile for the manual could not be run correctly as the generated function documentation was included, but not actually generated. This adds the necessary generation step by first building the XML file containing function locations and preserving its store path in a variable, which is then used both for linking of the locations file and as a build input for the function docs generator. This fixes #55014
2019-02-01 03:45:30 -07:00
manual-full.xml: ${MD_TARGETS} .version functions/library/locations.xml functions/library/generated *.xml **/*.xml **/**/*.xml
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
xmllint --nonet --xinclude --noxincludenode manual.xml --output manual-full.xml
.version:
nix-instantiate --eval \
treewide: rename version attributes As suggested in https://github.com/NixOS/nixpkgs/pull/39416#discussion_r183845745 the versioning attributes in `lib` should be consistent to `nixos/version` which implicates the following changes: * `lib.trivial.version` -> `lib.trivial.release` * `lib.trivial.suffix` -> `lib.trivial.versionSuffix` * `lib.nixpkgsVersion` -> `lib.version` As `lib.nixpkgsVersion` is referenced several times in `NixOS/nixpkgs`, `NixOS/nix` and probably several user's setups. As the rename will cause a notable impact it's better to keep `lib.nixpkgsVersion` as alias with a warning yielded by `builtins.trace`.
2018-04-26 02:31:05 -06:00
-E '(import ../lib).version' > .version
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
doc: Include function doc generation in Makefile Since #53055 was merged the Makefile for the manual could not be run correctly as the generated function documentation was included, but not actually generated. This adds the necessary generation step by first building the XML file containing function locations and preserving its store path in a variable, which is then used both for linking of the locations file and as a build input for the function docs generator. This fixes #55014
2019-02-01 03:45:30 -07:00
function_locations := $(shell nix-build --no-out-link ./lib-function-locations.nix)
Generate links to function definitions Hydra passes the full revision in to the input, which we pass through. If we don't get this ,we try to get it from other sources, or default to master which should have the definition in a close-ish location. All published docs should have theURL resolve properly, only local hackers will have the link break.
2018-10-05 08:46:58 -06:00
functions/library/locations.xml:
doc: Include function doc generation in Makefile Since #53055 was merged the Makefile for the manual could not be run correctly as the generated function documentation was included, but not actually generated. This adds the necessary generation step by first building the XML file containing function locations and preserving its store path in a variable, which is then used both for linking of the locations file and as a build input for the function docs generator. This fixes #55014
2019-02-01 03:45:30 -07:00
ln -s $(function_locations) ./functions/library/locations.xml
functions/library/generated:
nix-build ./lib-function-docs.nix \
--arg locationsXml $(function_locations)\
--out-link ./functions/library/generated
Generate links to function definitions Hydra passes the full revision in to the input, which we pass through. If we don't get this ,we try to get it from other sources, or default to master which should have the definition in a close-ish location. All published docs should have theURL resolve properly, only local hackers will have the link break.
2018-10-05 08:46:58 -06:00
docs: Build with a makefile
2018-03-24 09:36:10 -06:00
%.section.xml: %.section.md
pandoc $^ -w docbook+smart \
-f markdown+smart \
| sed -e 's|<ulink url=|<link xlink:href=|' \
-e 's|</ulink>|</link>|' \
-e 's|<sect. id=|<section xml:id=|' \
-e 's|</sect[0-9]>|</section>|' \
-e '1s| id=| xml:id=|' \
-e '1s|\(<[^ ]* \)|\1xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" |' \
| cat > $@
%.chapter.xml: %.chapter.md
pandoc $^ -w docbook+smart \
--top-level-division=chapter \
-f markdown+smart \
| sed -e 's|<ulink url=|<link xlink:href=|' \
-e 's|</ulink>|</link>|' \
-e 's|<sect. id=|<section xml:id=|' \
-e 's|</sect[0-9]>|</section>|' \
-e '1s| id=| xml:id=|' \
-e '1s|\(<[^ ]* \)|\1|' \
| cat > $@
Reference in New Issue Copy Permalink