Docbook Editor Configuration: Difference between revisions

From NixOS Wiki
imported>Disassembler
Adds vim editor for docbook settings
m fix syntax highlighting errors
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{outdated|This page may not see useful updates now that NixOS and Nixpkgs use markdown as the authoring format of the documentation.<br />The content may still be accurate.}}
==For Vim/Neovim==
<syntaxhighlight lang="nix">
(pkgs.neovim.override {
  configure.packages.myplugins.start = with pkgs.vimPlugins; [
    vim-docbk
    vim-docbk-snippets
    syntastic
    UltiSnips
  ];
})
</syntaxhighlight>
== For Emacs ==
== For Emacs ==


Line 30: Line 44:
</syntaxhighlight>
</syntaxhighlight>


==For Vim/Neovim==
== For IntelliJ IDEA (Community and Ultimate) ==
<syntaxhighlight lang="nix">
 
let
First off, the feature set for XML and Docbook editing is the same in both versions. Here's a neat one-liner to start the Community edition
  pkgs = import <nixpkgs> {};
 
  buildVimPlugin = pkgs.vimUtils.buildVimPluginFrom2Nix;
<syntaxhighlight lang="console">
  custom_plugins = {
nix-shell -p jetbrains.idea-community --run idea-community
    "vim_docbk" = buildVimPlugin {
</syntaxhighlight>
      name = "vim-docbk";
 
      src = pkgs.fetchgit {
Then, open the <tt>doc/</tt> or root folder of the <tt>&lt;nixpkgs&gt;</tt> project. (Opening a file directly will not allow browsing the directory structure within the IDE.
        url = "https://github.com/jhradilek/vim-docbk";
 
        rev = "6ac0346ce96dbefe982b9e765a81c072997f2e9e";
[[File:Docbook-intellij-open.png]]
        sha256 = "1jnx39m152hf9j620ygagaydg6h8m8gxkr1fmxj6kgqf71jr0n9d";
 
      };
=== Adding the docbook schema ===
      dependencies = [];
 
    };
At the root of <tt>&lt;nixpkgs&gt;</tt>, run the following command. It will create a link to docbook, allowing (easier) use of the
    "jhradilek_snippets" = buildVimPlugin {
xsd files. The symlink can be updated instead of having to change the full store path in the editor. The second command will print the full path to the docbook xsd.
      name = "jhradilek_snippets";
 
      src = pkgs.fetchgit {
<syntaxhighlight lang="console">
        url = "https://github.com/jhradilek/vim-snippets";
$ nix-build -A docbook5 --out-link docbook
        rev = "bf7e6742ac0a2ddc6bab5593bd2a2c6b75269bb8";
$ echo $PWD/docbook/share/xml/docbook-5.0/xsd/docbook.xsd
        sha256 = "1h7cp0p1z8r7w9bg2l79n5gg047xp8j8kg1xnn0finxqyb45lqif";
      };
      dependencies = [];
    };
  };
  nvim = pkgs.neovim.override {
    configure = {
      vam = {
        knownPlugins = pkgs.vimPlugins // custom_plugins;
        pluginDictionaries = [
          {
            names = [
              "vim_docbk"
              "jhradilek_snippets"
              "syntastic"
              "UltiSnips"
            ];
          }
        ];
      };
    };
  };
in
pkgs.stdenv.mkDerivation rec {
  name = "Docbook_Vim";
  buildInputs = [ nvim ];
}
</syntaxhighlight>
</syntaxhighlight>
Open <tt>manual.xml</tt>. After a short while, IntelliJ IDEA will realise it does not know about the schema.
[[File:Docbook-intellij-schema-error.png]]
Click on the red light bulb, then <em>Manually setup an external resource</em>.
[[File:Docbook-intellij-bulb-menu.png]]
Paste in the full path to the <tt>xsd</tt> file.
[[File:Docbook-intellij-full-path.png]]
After this is done, IntelliJ will validate.
[[File:Docbook-intellij-mistake.png]]

Latest revision as of 18:45, 21 June 2024

For Vim/Neovim

(pkgs.neovim.override {
   configure.packages.myplugins.start = with pkgs.vimPlugins; [
     vim-docbk
     vim-docbk-snippets
     syntastic
     UltiSnips
   ];
 })

For Emacs

The following creates an Emacs with a custom module, which configures nXML for the NixOS / Nixpkgs docbook codebase:

let
  pkgs = import <nixpkgs> {};
  inherit (pkgs) emacsPackagesNg docbook5 writeText;

  schemas = writeText "schemas.xml" ''
    <locatingRules xmlns="http://thaiopensource.com/ns/locating-rules/1.0">
      <documentElement localName="section" typeId="DocBook"/>
      <documentElement localName="chapter" typeId="DocBook"/>
      <documentElement localName="article" typeId="DocBook"/>
      <documentElement localName="book" typeId="DocBook"/>
      <typeId id="DocBook" uri="${docbook5}/xml/rng/docbook/docbookxi.rnc" />
    </locatingRules>
  '';

in emacsPackagesNg.emacsWithPackages (epkgs: [
  (emacsPackagesNg.trivialBuild {
    pname = "nix-docbook-mode";
    version = "1970-01-01";
    src = writeText "default.el" ''
      (eval-after-load 'rng-loc
        '(add-to-list 'rng-schema-locating-files "${schemas}"))
    '';
  })
])

For IntelliJ IDEA (Community and Ultimate)

First off, the feature set for XML and Docbook editing is the same in both versions. Here's a neat one-liner to start the Community edition

nix-shell -p jetbrains.idea-community --run idea-community

Then, open the doc/ or root folder of the <nixpkgs> project. (Opening a file directly will not allow browsing the directory structure within the IDE.

Adding the docbook schema

At the root of <nixpkgs>, run the following command. It will create a link to docbook, allowing (easier) use of the xsd files. The symlink can be updated instead of having to change the full store path in the editor. The second command will print the full path to the docbook xsd.

$ nix-build -A docbook5 --out-link docbook
$ echo $PWD/docbook/share/xml/docbook-5.0/xsd/docbook.xsd

Open manual.xml. After a short while, IntelliJ IDEA will realise it does not know about the schema.

Click on the red light bulb, then Manually setup an external resource.

Paste in the full path to the xsd file.

After this is done, IntelliJ will validate.