From 50783a8b00a0394346c0bd63ae92360f8cc310bc Mon Sep 17 00:00:00 2001
From: leonardolara <leonardo.lara.rodrigues@gmail.com>
Date: Tue, 3 Sep 2024 11:24:42 -0300
Subject: [PATCH] initial translation in reference/rnp

---
 reference/rnp/book.xml      | 44 +++++++++++++++++++++++++++
 reference/rnp/configure.xml | 30 +++++++++++++++++++
 reference/rnp/examples.xml  | 55 ++++++++++++++++++++++++++++++++++
 reference/rnp/reference.xml | 27 +++++++++++++++++
 reference/rnp/rnpffi.xml    | 59 +++++++++++++++++++++++++++++++++++++
 reference/rnp/setup.xml     | 36 ++++++++++++++++++++++
 6 files changed, 251 insertions(+)
 create mode 100644 reference/rnp/book.xml
 create mode 100644 reference/rnp/configure.xml
 create mode 100644 reference/rnp/examples.xml
 create mode 100644 reference/rnp/reference.xml
 create mode 100644 reference/rnp/rnpffi.xml
 create mode 100644 reference/rnp/setup.xml

diff --git a/reference/rnp/book.xml b/reference/rnp/book.xml
new file mode 100644
index 000000000..8dde04eff
--- /dev/null
+++ b/reference/rnp/book.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: leonardolara Status: ready -->
+<book xml:id="book.rnp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <?phpdoc extension-membership="pecl" ?>
+ <title>Rnp</title>
+ <titleabbrev>Rnp</titleabbrev>
+
+ <preface xml:id="intro.rnp">
+  &reftitle.intro;
+  <para>
+   Este módulo permite usar a biblioteca <link
+   xlink:href="&url.rnp;">RNP</link>.
+   RNP é uma biblioteca OpenPGP em C++ de alto
+   desempanho usada pelo Mozilla Thunderbird.
+  </para>
+ </preface>
+
+ &reference.rnp.setup;
+ &reference.rnp.constants;
+ &reference.rnp.examples;
+ &reference.rnp.reference;
+
+ &reference.rnp.rnpffi;
+
+</book>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/rnp/configure.xml b/reference/rnp/configure.xml
new file mode 100644
index 000000000..35ad8c5a1
--- /dev/null
+++ b/reference/rnp/configure.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: leonardolara Status: ready -->
+<section xml:id="rnp.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.install;
+
+ <para>
+  &pecl.info;
+  <link xlink:href="&url.pecl.package;rnp">&url.pecl.package;rnp</link>
+ </para>
+
+</section>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/rnp/examples.xml b/reference/rnp/examples.xml
new file mode 100644
index 000000000..25a9d4c9e
--- /dev/null
+++ b/reference/rnp/examples.xml
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: leonardolara Status: ready -->
+<chapter xml:id="rnp.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.examples;
+ <section xml:id="rnp.examples-clearsign">
+  <title>Texto Clearsign</title>
+  <para>
+   Este exemplo faz assinatura clearsign em um texto.
+  </para>
+  <example>
+   <title>Exemplo de clearsign RNP</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// inicializa objeto FFI
+$ffi = rnp_ffi_create('GPG', 'GPG');
+
+// gera chave RSA
+$key = rnp_op_generate_key($ffi, 'test@example.com', 'RSA');
+
+// assina
+$data = "Texto de exemplo para assinar";
+$signature = rnp_op_sign_cleartext($ffi, $data, array($key));
+
+echo $signature;
+
+// destrói o objeto FFI
+rnp_ffi_destroy($ffi);
+?>
+]]>
+   </programlisting>
+  </example>
+ </section>
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/rnp/reference.xml b/reference/rnp/reference.xml
new file mode 100644
index 000000000..d3c88b959
--- /dev/null
+++ b/reference/rnp/reference.xml
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 79bc1248b2295d9c9f0837d1ddcaea9d7c2853a7 Maintainer: leonardolara Status: ready -->
+<reference xml:id="ref.rnp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>&Functions; de Rnp</title>
+
+ &reference.rnp.entities.functions;
+
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/rnp/rnpffi.xml b/reference/rnp/rnpffi.xml
new file mode 100644
index 000000000..464bd4be6
--- /dev/null
+++ b/reference/rnp/rnpffi.xml
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: leonardolara Status: ready -->
+<reference xml:id="class.rnpffi" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>A classe RnpFFI</title>
+ <titleabbrev>RnpFFI</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ RnpFFI intro -->
+  <section xml:id="rnpffi.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="rnpffi.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>RnpFFI</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>RnpFFI</classname>
+     </ooclass>
+    </classsynopsisinfo>
+<!-- }}} -->
+
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/rnp/setup.xml b/reference/rnp/setup.xml
new file mode 100644
index 000000000..e6ccc055f
--- /dev/null
+++ b/reference/rnp/setup.xml
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: leonardolara Status: ready -->
+<chapter xml:id="rnp.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.setup;
+
+ <section xml:id="rnp.requirements">
+  &reftitle.required;
+  <para>
+   Para usar as funções RNP é necessário instalar a biblioteca <link
+   xlink:href="&url.rnp;">RNP</link>. Versão &gt;= 0.16.2 da biblioteca
+   é requerida.
+  </para>
+ </section>
+
+ &reference.rnp.configure;
+
+</chapter>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->