summaryrefslogtreecommitdiff
path: root/doc/Makefile (follow)
Commit message (Expand)AuthorAgeFilesLines
* doc: Add helper for converting DocBook files to MarkdownJan Tojnar2021-07-131-1/+1
* doc: Linkify man page referencesJan Tojnar2021-07-131-0/+1
* doc: Add support for MyST roles•••Officially, only the manpage role is supported at the moment. Unlike in rST, the syntax uses braces instead of colons: {manpage}`nix.conf(5)` Jan Tojnar2021-07-131-0/+4
* doc: Move lua filters to subdirectoryJan Tojnar2021-07-121-1/+1
* nixos/doc: Synchronize the Markdown generator with Nixpkgs•••Switch to CommonMark with our extensions. Jan Tojnar2021-06-181-2/+3
* Merge pull request #125671 from SFrijters/doc-improve-make-clean•••doc: Clean up generated media directoryRyan Mulligan2021-06-121-1/+1
|\
| * doc: Clean up generated media directory•••pandoc uses ./media to extract media files - add it to the list of directories that need to be removed by `make clean`. Stefan Frijters2021-06-041-1/+1
* | doc: Use markdown syntax for xrefs•••Syntax is taken from MyST: https://myst-parser.readthedocs.io/en/latest/using/syntax.html#targets-and-cross-referencing Jan Tojnar2021-06-071-0/+1
* | doc: Build as CommonMark•••We were using Pandoc’s Markdown parser. This is non-standard and might cause issues when we finally switch to some other tool. Since RFC 0072 agreed on CommonMark, let’s switch to that. We will use some extensions to make the limited syntax bearable but these are official so they should be more portable. Jan Tojnar2021-06-071-10/+15
|/
* doc/README.md: initRobert Hensing2021-03-041-1/+1
* doc: Add staging workflow diagramJan Tojnar2020-12-091-0/+6
* doc: clean up makefile•••The sectn and ulink hacks are not necessary since pandoc has been defaulting to Docbook 5 for a long time. With the pandoc patches, we can get rid of id→xml:id replacement and xmlns hacks as well. Jan Tojnar2020-12-071-14/+2
* doc: fix MD_TARGETS•••globstar (**) does not work in Makefile Mitsuhiro Nakamura2020-07-181-1/+1
* nixpkgs manual: fix build after pandoc(?) update•••I din't try to pinpoint the exact commit, but we started getting: > The extension smart is not supported for docbook Reading pandoc docs, I can't see what use to us "smart" could be when writing the in-between docbook (to be converted to html). https://pandoc.org/MANUAL.html#extension-smart Vladimír Čunát2020-03-021-2/+2
* doc: move parameters to an XML fileGraham Christensen2019-07-041-4/+4
* xmlformat.conf: move to doc-support buildGraham Christensen2019-07-041-2/+2
* docs: Get highlightjs from build symlinkGraham Christensen2019-07-041-5/+5
* docs: get XSL from build / symlinkGraham Christensen2019-07-041-5/+5
* docs: find docbook rng from doc-supportGraham Christensen2019-07-041-2/+2
* docs: get version from doc-support buildGraham Christensen2019-07-041-4/+3
* docs: use a single nix-build for all the generate function docsGraham Christensen2019-07-041-8/+8
* manual: Make sure building doesn't need recursive nix•••$(shell ...) looks a little sketch like it will be run no matter what. And there are problems building the manual on darwin so hopefully this fixes them. John Ericson2019-03-241-6/+5
* 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 Vincent Ambo2019-02-011-4/+10
* manual: document ways of obtaining source hashes•••... and security nuances danbst2019-01-111-2/+4
* 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. Graham Christensen2018-10-051-2/+6
* 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. Graham Christensen2018-10-051-1/+1
* nixpkgs docs: Rebuild manual-full if nested XML docs changeGraham Christensen2018-10-021-1/+1
* 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 Samuel Dionne-Riel2018-05-311-0/+5
* nixpkgs doc: add format Make targetGraham Christensen2018-04-301-1/+6
* 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`. Maximilian Bosch2018-04-281-1/+1
* 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 Graham Christensen2018-04-051-7/+1
* nixpkgs docs: syntax highlightGraham Christensen2018-03-261-3/+21
* Move the overridden CSS to overrides.css which can be applied on nixos.orgGraham Christensen2018-03-261-0/+2
* nixpkgs docs: Use SVGs for calloutsGraham Christensen2018-03-261-4/+6
* Add 'make debug' to call xmloscopyGraham Christensen2018-03-251-0/+3
* Move validate to top-level so it doesn't rebuild the outputs every timeGraham Christensen2018-03-251-3/+5
* Validate when building outputsGraham Christensen2018-03-251-2/+2
* docs: Build with a makefileGraham Christensen2018-03-251-0/+69
* Nixpkgs manual: Add a Nix expression to buildEelco Dolstra2014-08-241-41/+0
* Manual: html -> xhtmlEelco Dolstra2014-07-031-3/+3
* * Build a PDF of the manual.•••svn path=/nixpkgs/trunk/; revision=16316 Eelco Dolstra2009-07-101-2/+6
* * Manual outline.•••svn path=/nixpkgs/trunk/; revision=12057 Eelco Dolstra2008-06-121-1/+8
* * Release notes.•••* Linux 2.6.22.6. * w3m 0.5.2. svn path=/nixpkgs/trunk/; revision=9305 Eelco Dolstra2007-09-111-0/+3
* * Start of Nixpkgs 0.10 release notes.•••svn path=/nixpkgs/trunk/; revision=6676 Eelco Dolstra2006-10-061-5/+5
* * NEWS in DocBook.•••svn path=/nixpkgs/trunk/; revision=4627 Eelco Dolstra2006-01-301-0/+27