nixos/jitsi-meet: convert manual chapter to MD

This commit is contained in:
pennae 2023-01-03 07:14:51 +01:00
parent 1be48def96
commit b5990a47e0
3 changed files with 73 additions and 32 deletions

View File

@ -0,0 +1,45 @@
# Jitsi Meet {#module-services-jitsi-meet}
With Jitsi Meet on NixOS you can quickly configure a complete,
private, self-hosted video conferencing solution.
## Basic usage {#module-services-jitsi-basic-usage}
A minimal configuration using Let's Encrypt for TLS certificates looks like this:
```
{
services.jitsi-meet = {
enable = true;
hostName = "jitsi.example.com";
};
services.jitsi-videobridge.openFirewall = true;
networking.firewall.allowedTCPPorts = [ 80 443 ];
security.acme.email = "me@example.com";
security.acme.acceptTerms = true;
}
```
## Configuration {#module-services-jitsi-configuration}
Here is the minimal configuration with additional configurations:
```
{
services.jitsi-meet = {
enable = true;
hostName = "jitsi.example.com";
config = {
enableWelcomePage = false;
prejoinPageEnabled = true;
defaultLang = "fi";
};
interfaceConfig = {
SHOW_JITSI_WATERMARK = false;
SHOW_WATERMARK_FOR_GUESTS = false;
};
};
services.jitsi-videobridge.openFirewall = true;
networking.firewall.allowedTCPPorts = [ 80 443 ];
security.acme.email = "me@example.com";
security.acme.acceptTerms = true;
}
```

View File

@ -451,6 +451,8 @@ in
}; };
}; };
# Don't edit the docbook xml directly, edit the md and generate it:
# `pandoc jitsi-meet.md -t docbook --top-level-division=chapter --extract-media=media -f markdown-smart --lua-filter ../../../../doc/build-aux/pandoc-filters/myst-reader/roles.lua --lua-filter ../../../../doc/build-aux/pandoc-filters/docbook-writer/rst-roles.lua > jitsi-meet.xml`
meta.doc = ./jitsi-meet.xml; meta.doc = ./jitsi-meet.xml;
meta.maintainers = lib.teams.jitsi.members; meta.maintainers = lib.teams.jitsi.members;
} }

View File

@ -1,46 +1,42 @@
<chapter xmlns="http://docbook.org/ns/docbook" <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="module-services-jitsi-meet">
xmlns:xlink="http://www.w3.org/1999/xlink" <title>Jitsi Meet</title>
xmlns:xi="http://www.w3.org/2001/XInclude" <para>
version="5.0" With Jitsi Meet on NixOS you can quickly configure a complete,
xml:id="module-services-jitsi-meet"> private, self-hosted video conferencing solution.
<title>Jitsi Meet</title> </para>
<para> <section xml:id="module-services-jitsi-basic-usage">
With Jitsi Meet on NixOS you can quickly configure a complete, <title>Basic usage</title>
private, self-hosted video conferencing solution. <para>
</para> A minimal configuration using Let's Encrypt for TLS certificates
looks like this:
<section xml:id="module-services-jitsi-basic-usage"> </para>
<title>Basic usage</title> <programlisting>
<para>
A minimal configuration using Let's Encrypt for TLS certificates looks like this:
<programlisting>
{ {
services.jitsi-meet = { services.jitsi-meet = {
enable = true; enable = true;
hostName = "jitsi.example.com"; hostName = &quot;jitsi.example.com&quot;;
}; };
services.jitsi-videobridge.openFirewall = true; services.jitsi-videobridge.openFirewall = true;
networking.firewall.allowedTCPPorts = [ 80 443 ]; networking.firewall.allowedTCPPorts = [ 80 443 ];
security.acme.email = "me@example.com"; security.acme.email = &quot;me@example.com&quot;;
security.acme.acceptTerms = true; security.acme.acceptTerms = true;
} }
</programlisting> </programlisting>
</para> </section>
</section> <section xml:id="module-services-jitsi-configuration">
<title>Configuration</title>
<section xml:id="module-services-jitsi-configuration"> <para>
<title>Configuration</title> Here is the minimal configuration with additional configurations:
<para> </para>
Here is the minimal configuration with additional configurations: <programlisting>
<programlisting>
{ {
services.jitsi-meet = { services.jitsi-meet = {
enable = true; enable = true;
hostName = "jitsi.example.com"; hostName = &quot;jitsi.example.com&quot;;
config = { config = {
enableWelcomePage = false; enableWelcomePage = false;
prejoinPageEnabled = true; prejoinPageEnabled = true;
defaultLang = "fi"; defaultLang = &quot;fi&quot;;
}; };
interfaceConfig = { interfaceConfig = {
SHOW_JITSI_WATERMARK = false; SHOW_JITSI_WATERMARK = false;
@ -49,11 +45,9 @@
}; };
services.jitsi-videobridge.openFirewall = true; services.jitsi-videobridge.openFirewall = true;
networking.firewall.allowedTCPPorts = [ 80 443 ]; networking.firewall.allowedTCPPorts = [ 80 443 ];
security.acme.email = "me@example.com"; security.acme.email = &quot;me@example.com&quot;;
security.acme.acceptTerms = true; security.acme.acceptTerms = true;
} }
</programlisting> </programlisting>
</para> </section>
</section>
</chapter> </chapter>