Convert the Messengers page to HTML admonitions (#2383)

Signed-off-by: Daniel Gray <dngray@privacyguides.org>

docs/real-time-communication.md

@@ -16,7 +16,7 @@ These messengers are great for securing your sensitive communications.
 
 ### Signal
 
-!!! recommendation
+<div class="admonition recommendation" markdown>
 
 ![Signal logo](assets/img/messengers/signal.svg){ align=right }
 
@@ -30,7 +30,8 @@ These messengers are great for securing your sensitive communications.
 [:octicons-code-16:](https://github.com/signalapp){ .card-link title="Source Code" }
 [:octicons-heart-16:](https://signal.org/donate/){ .card-link title=Contribute }
 
-    ??? downloads
+<details class="downloads" markdown>
+<summary>Downloads</summary>
 
 - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=org.thoughtcrime.securesms)
 - [:simple-appstore: App Store](https://apps.apple.com/app/id874139669)
@@ -39,6 +40,10 @@ These messengers are great for securing your sensitive communications.
 - [:simple-apple: macOS](https://signal.org/download/macos)
 - [:simple-linux: Linux](https://signal.org/download/linux)
 
+</details>
+
+</div>
+
 Signal supports [private groups](https://signal.org/blog/signal-private-group-system/). The server has no record of your group memberships, group titles, group avatars, or group attributes. Signal has minimal metadata when [Sealed Sender](https://signal.org/blog/sealed-sender/) is enabled. The sender address is encrypted along with the message body, and only the recipient address is visible to the server. Sealed Sender is only enabled for people in your contacts list, but can be enabled for all recipients with the increased risk of receiving spam. Signal requires your phone number as a personal identifier.
 
 The protocol was independently [audited](https://eprint.iacr.org/2016/1013.pdf) in 2016. The specification for the Signal protocol can be found in their [documentation](https://signal.org/docs/).
@@ -49,7 +54,7 @@ We have some additional tips on configuring and hardening your Signal installati
 
 ### SimpleX Chat
 
-!!! recommendation
+<div class="admonition recommendation" markdown>
 
 ![Simplex logo](assets/img/messengers/simplex.svg){ align=right }
 
@@ -60,7 +65,8 @@ We have some additional tips on configuring and hardening your Signal installati
 [:octicons-info-16:](https://github.com/simplex-chat/simplex-chat/tree/stable/docs){ .card-link title=Documentation}
 [:octicons-code-16:](https://github.com/simplex-chat){ .card-link title="Source Code" }
 
-    ??? downloads
+<details class="downloads" markdown>
+<summary>Downloads</summary>
 
 - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=chat.simplex.app)
 - [:simple-appstore: App Store](https://apps.apple.com/us/app/simplex-chat/id1605771084)
@@ -69,13 +75,17 @@ We have some additional tips on configuring and hardening your Signal installati
 - [:simple-apple: macOS](https://simplex.chat/downloads/#desktop-app)
 - [:simple-linux: Linux](https://simplex.chat/downloads/#desktop-app)
 
+</details>
+
+</div>
+
 SimpleX Chat [was audited](https://simplex.chat/blog/20221108-simplex-chat-v4.2-security-audit-new-website.html) by Trail of Bits in October 2022.
 
 SimpleX Chat supports basic group chatting functionality, direct messaging, and editing of messages and markdown. E2EE Audio and Video calls are also supported. Your data can be exported, and imported onto another device, as there are no central servers where this is backed up.
 
 ### Briar
 
-!!! recommendation
+<div class="admonition recommendation" markdown>
 
 ![Briar logo](assets/img/messengers/briar.svg){ align=right }
 
@@ -87,13 +97,18 @@ SimpleX Chat supports basic group chatting functionality, direct messaging, and
 [:octicons-code-16:](https://code.briarproject.org/briar/briar){ .card-link title="Source Code" }
 [:octicons-heart-16:](https://briarproject.org/){ .card-link title="Donation options are listed on the bottom of the homepage" }
 
-    ??? downloads
+<details class="downloads" markdown>
+<summary>Downloads</summary>
 
 - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=org.briarproject.briar.android)
 - [:simple-windows11: Windows](https://briarproject.org/download-briar-desktop/)
 - [:simple-linux: Linux](https://briarproject.org/download-briar-desktop/)
 - [:simple-flathub: Flathub](https://flathub.org/apps/details/org.briarproject.Briar)
 
+</details>
+
+</div>
+
 To add a contact on Briar, you must both add each other first. You can either exchange `briar://` links or scan a contact’s QR code if they are nearby.
 
 The client software was independently [audited](https://briarproject.org/news/2017-beta-released-security-audit/), and the anonymous routing protocol uses the Tor network which has also been audited.
@@ -104,13 +119,16 @@ Briar supports Forward Secrecy by using the Bramble [Handshake](https://code.bri
 
 ## Additional Options
 
-!!! warning
+<div class="admonition warning" markdown>
+<p class="admonition-title">Warning</p>
 
 These messengers do not have [Forward Secrecy](https://en.wikipedia.org/wiki/Forward_secrecy), and while they fulfill certain needs that our previous recommendations may not, we do not recommend them for long-term or sensitive communications. Any key compromise among message recipients would affect the confidentiality of **all** past communications.
 
+</div>
+
 ### Element
 
-!!! recommendation
+<div class="admonition recommendation" markdown>
 
 ![Element logo](assets/img/messengers/element.svg){ align=right }
 
@@ -123,7 +141,8 @@ Briar supports Forward Secrecy by using the Bramble [Handshake](https://code.bri
 [:octicons-info-16:](https://element.io/help){ .card-link title=Documentation}
 [:octicons-code-16:](https://github.com/vector-im){ .card-link title="Source Code" }
 
-    ??? downloads
+<details class="downloads" markdown>
+<summary>Downloads</summary>
 
 - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=im.vector.app)
 - [:simple-appstore: App Store](https://apps.apple.com/app/vector/id1083446067)
@@ -133,6 +152,10 @@ Briar supports Forward Secrecy by using the Bramble [Handshake](https://code.bri
 - [:simple-linux: Linux](https://element.io/get-started)
 - [:octicons-globe-16: Web](https://app.element.io)
 
+</details>
+
+</div>
+
 Profile pictures, reactions, and nicknames are not encrypted.
 
 Group voice and video calls are [not](https://github.com/vector-im/element-web/issues/12878) E2EE, and use Jitsi, but this is expected to change with [Native Group VoIP Signalling](https://github.com/matrix-org/matrix-doc/pull/3401). Group calls have [no authentication](https://github.com/vector-im/element-web/issues/13074) currently, meaning that non-room participants can also join the calls. We recommend that you do not use this feature for private meetings.
@@ -143,7 +166,7 @@ The protocol was independently [audited](https://matrix.org/blog/2016/11/21/matr
 
 ### Session
 
-!!! recommendation
+<div class="admonition recommendation" markdown>
 
 ![Session logo](assets/img/messengers/session.svg){ align=right }
 
@@ -156,7 +179,8 @@ The protocol was independently [audited](https://matrix.org/blog/2016/11/21/matr
 [:octicons-info-16:](https://getsession.org/faq){ .card-link title=Documentation}
 [:octicons-code-16:](https://github.com/oxen-io){ .card-link title="Source Code" }
 
-    ??? downloads
+<details class="downloads" markdown>
+<summary>Downloads</summary>
 
 - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=network.loki.messenger)
 - [:simple-appstore: App Store](https://apps.apple.com/app/id1470168868)
@@ -165,6 +189,10 @@ The protocol was independently [audited](https://matrix.org/blog/2016/11/21/matr
 - [:simple-apple: macOS](https://getsession.org/download)
 - [:simple-linux: Linux](https://getsession.org/download)
 
+</details>
+
+</div>
+
 Session allows for E2EE in one-on-one chats or closed groups which allow for up to 100 members. Open groups have no restriction on the number of members, but are open by design.
 
 Session does [not](https://getsession.org/blog/session-protocol-technical-information) support PFS, which is when an encryption system automatically and frequently changes the keys it uses to encrypt and decrypt information, such that if the latest key is compromised it exposes a smaller portion of sensitive information.
@@ -177,10 +205,13 @@ Session has a [whitepaper](https://arxiv.org/pdf/2002.04609.pdf) describing the
 
 **Please note we are not affiliated with any of the projects we recommend.** In addition to [our standard criteria](about/criteria.md), we have developed a clear set of requirements to allow us to provide objective recommendations. We suggest you familiarize yourself with this list before choosing to use a project, and conduct your own research to ensure it's the right choice for you.
 
-!!! example "This section is new"
+<div class="admonition example" markdown>
+<p class="admonition-title">This section is new</p>
 
 We are working on establishing defined criteria for every section of our site, and this may be subject to change. If you have any questions about our criteria, please [ask on our forum](https://discuss.privacyguides.net/latest) and don't assume we didn't consider something when making our recommendations if it is not listed here. There are many factors considered and discussed when we recommend a project, and documenting every single one is a work-in-progress.
 
+</div>
+
 - Must have open-source clients.
 - Must use E2EE for private messages by default.
 - Must support E2EE for all messages.