nordic-dev.net/nixpkgs
nordic-dev.net/nixpkgs
2
0
Fork 0
mirror of https://github.com/NixOS/nixpkgs.git synced 2024-11-23 07:23:20 +00:00
Code Issues Packages Projects Releases Wiki Activity
4312cfdbda
nixpkgs/doc/Makefile

101 lines
2.9 KiB
Makefile
Raw Normal View History

docs: Build with a makefile
2018-03-24 15:36:10 +00:00
MD_TARGETS=$(addsuffix .xml, $(basename $(wildcard ./*.md ./**/*.md)))
.PHONY: all
nixpkgs doc: add format Make target
2018-05-01 02:35:54 +00:00
all: validate format out/html/index.html out/epub/manual.epub
docs: Build with a makefile
2018-03-24 15:36:10 +00:00
Add 'make debug' to call xmloscopy
2018-03-26 00:01:31 +00:00
.PHONY: debug
debug:
nix-shell --run "xmloscopy --docbook5 ./manual.xml ./manual-full.xml"
nixpkgs docs: syntax highlight
2018-03-26 12:24:27 +00:00
nixpkgs doc: add format Make target
2018-05-01 02:35:54 +00:00
.PHONY: format
format:
find . -iname '*.xml' -type f -print0 | xargs -0 -I{} -n1 \
xmlformat --config-file "$$XMLFORMAT_CONFIG" -i {}
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-06-01 00:26:27 +00: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 15:36:10 +00:00
.PHONY: clean
clean:
rm -f ${MD_TARGETS} .version manual-full.xml
nixpkgs docs: syntax highlight
2018-03-26 12:24:27 +00:00
rm -rf ./out/ ./highlightjs
docs: Build with a makefile
2018-03-24 15:36:10 +00:00
Move validate to top-level so it doesn't rebuild the outputs every time
2018-03-25 11:37:41 +00:00
.PHONY: validate
docs: Build with a makefile
2018-03-24 15:36:10 +00:00
validate: manual-full.xml
jing "$$RNG" manual-full.xml
nixpkgs docs: syntax highlight
2018-03-26 12:24:27 +00:00
out/html/index.html: manual-full.xml style.css highlightjs
docs: Build with a makefile
2018-03-24 15:36:10 +00:00
mkdir -p out/html
nixpkgs docs: Use SVGs for callouts
2018-03-26 18:04:19 +00:00
xsltproc ${xsltFlags} \
docs: Build with a makefile
2018-03-24 15:36:10 +00:00
--nonet --xinclude \
--output $@ \
"$$XSL/docbook/xhtml/docbook.xsl" \
./manual-full.xml
nixpkgs docs: syntax highlight
2018-03-26 12:24:27 +00: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 18:45:00 +00:00
cp ./overrides.css out/html/
docs: Build with a makefile
2018-03-24 15:36:10 +00:00
cp ./style.css out/html/style.css
mkdir -p out/html/images/callouts
nixpkgs docs: Use SVGs for callouts
2018-03-26 18:04:19 +00:00
cp "$$XSL/docbook/images/callouts/"*.svg out/html/images/callouts/
nixpkgs docs: syntax highlight
2018-03-26 12:24:27 +00:00
chmod u+w -R out/html/
docs: Build with a makefile
2018-03-24 15:36:10 +00:00
Move validate to top-level so it doesn't rebuild the outputs every time
2018-03-25 11:37:41 +00:00
out/epub/manual.epub: manual-full.xml
docs: Build with a makefile
2018-03-24 15:36:10 +00:00
mkdir -p out/epub/scratch
nixpkgs docs: Use SVGs for callouts
2018-03-26 18:04:19 +00:00
xsltproc ${xsltFlags} --nonet \
docs: Build with a makefile
2018-03-24 15:36:10 +00: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 18:45:00 +00:00
cp ./overrides.css out/epub/scratch/OEBPS
nixpkgs docs: Use SVGs for callouts
2018-03-26 18:04:19 +00: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 15:36:10 +00: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 12:24:27 +00: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 11:54:01 +00:00
cp -r "$$HIGHLIGHTJS/loader.js" highlightjs/
nixpkgs docs: syntax highlight
2018-03-26 12:24:27 +00:00
nixpkgs: Start documenting library functions in XML Covers assert functions and about half of the attrsets functions. Some internal consistency around IDs could be improved.
2018-10-02 20:06:33 +00:00
manual-full.xml: ${MD_TARGETS} .version *.xml **/*.xml **/**/*.xml
docs: Build with a makefile
2018-03-24 15:36:10 +00: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 08:31:05 +00:00
-E '(import ../lib).version' > .version
docs: Build with a makefile
2018-03-24 15:36:10 +00: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