nixpkgs/nixos/doc/manual/from_md
Colin Arnott 66e0e5ad74
nixos/wordpress: plugins and themes as attrs
In an effort to better encode version strings and use descriptive pnames
that do not conflict with top level pkgs, we currently use
wordpress-${type}-${pname} for pname. This is good for the nix store,
but when we synthesize the wordpress derivation in our module, we reuse
this pname for the output directory.

Internally wordpress can handle this fine, since plugins must register
via php, not directory. Unfortunately, many plugins like civicrm and
wpforms-lite are designed to rely upon the name of their install
directory for homing or discovery.

As such, we should follow both the upstream convention and
services.nextcloud.extraApps and use an attribute set for these options.
This allows us to not have to deal with the implementation details of
plugins and themes, which differ from official and third party, but also
give users the option to override the install location. The only issue
is that it breaks the current api.
2023-01-27 15:24:19 +00:00
..
administration nixos/doc: bump Pandoc 2022-12-27 17:23:25 +01:00
configuration services.openssh: support freeform settings (#193757) 2023-01-15 16:32:46 +01:00
development nixos/tests: extend shell_interact to accept alternative socat addresses 2023-01-27 13:09:25 +01:00
installation doc/installation: fix incorrect channel link 2023-01-03 15:24:36 -05:00
release-notes nixos/wordpress: plugins and themes as attrs 2023-01-27 15:24:19 +00:00
contributing-to-this-manual.chapter.xml nixos/manpages: Explain -I option and how to build manpages 2022-12-11 11:00:06 +01:00
README.md

This directory is temporarily needed while we transition the manual to CommonMark. It stores the output of the ../md-to-db.sh script that converts CommonMark files back to DocBook.

We are choosing to convert the Markdown to DocBook at authoring time instead of manual building time, because we do not want the pandoc toolchain to become part of the NixOS closure.

Do not edit the DocBook files inside this directory or its subdirectories. Instead, edit the corresponding .md file in the normal manual directories, and run ../md-to-db.sh to update the file here.