mirror of
https://github.com/freedombox/FreedomBox.git
synced 2026-01-21 07:55:00 +00:00
doc: Fetch latest manual
Signed-off-by: James Valleroy <jvalleroy@mailbox.org>
This commit is contained in:
James Valleroy
parent
d10b22c6ad
commit
5c55610234
@ -24,34 +24,106 @@ From code, design and translation to spreading the word and donation, here are a
|
||||
|
||||
As a new contributor, you are more than welcome to introduce yourself to others on the !FreedomBox [[https://discuss.freedombox.org/c/development|discussion forum]], [[http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss|mailing list]] or on the [[irc://irc.debian.org/freedombox|#freedombox IRC]] channel. In addition to make useful contacts, you can start reporting bugs and translate (see below) the wiki website and the !FreedomBox web interface.
|
||||
|
||||
== Development priorities ==
|
||||
|
||||
Upcoming priorities are discussed on an regular basis. You find the progress of the !FreedomBox Service with its priorities here: [[https://salsa.debian.org/groups/freedombox-team/-/boards|issues board]] and [[https://salsa.debian.org/groups/freedombox-team/-/milestones|milestones]].
|
||||
= Contributions needed =
|
||||
|
||||
Please check next [[FreedomBox/ProgressCalls|progress calls]] to keep yourself on track and meet members of the release team. A [[FreedomBox/TODO|TODO page]] aggregates the complete list of the items to work on for !FreedomBox.
|
||||
Sorted by ascending difficulty
|
||||
|
||||
== Contributions needed ==
|
||||
== Donate ==
|
||||
|
||||
=== Add an Application ===
|
||||
Obviously, donating is the easiest way to contribute.
|
||||
|
||||
If you are a developer and wish to see an application available in !FreedomBox, you can contribute by adding the application to !FreedomBox. See the [[https://docs.freedombox.org/|FreedomBox Developer Manual]]. Many applications that can be added to !FreedomBox have been identified on the [[FreedomBox/LeavingTheCloud|leaving the cloud]] page.
|
||||
You can help the project financially by donating via !PayPal, Bitcoin or by mailing a check. Please see the [[https://www.freedomboxfoundation.org/donate/|donation page]] for details on how to donate.
|
||||
|
||||
=== Bugs ===
|
||||
!FreedomBox project is run by volunteers. The [[https://freedomboxfoundation.org|FreedomBox Foundation]] is a 501(c)(3) federal nonprofit corporation with recognition from the IRS.
|
||||
|
||||
List of bugs, feature requests and improvements are tracked on the !FreedomBox [[https://salsa.debian.org/freedombox-team/freedombox/issues/|issue tracker]]. In addition to that, see [[FreedomBox/Contribute/Bugs|list of bugs]] to help out the Debian package we depend on. Also see the !FreedomBox [[https://qa.debian.org/developer.php?login=freedombox-pkg-team%40lists.alioth.debian.org&comaint=yes|packaging team's dashboard]] for status of various packages that we use.
|
||||
|
||||
=== Code ===
|
||||
== Spread the Word ==
|
||||
|
||||
Spreading the word about !FreedomBox only requires to know about the basic goals of the project and an overall description of the product.
|
||||
|
||||
Speak to your family, friends, local community or at global conferences about the importance of !FreedomBox. To be a successful project we need much more awareness and many more participants, be it users or contributors. Write about your efforts on the [[FreedomBox/TalksAndPresentations|wiki]].
|
||||
|
||||
If you are into marketing, you can get in touch with the marketing team through the [[https://discuss.freedombox.org/c/community/marketing/14|marketing section of our forum]].
|
||||
|
||||
|
||||
== Feed Us Back (Comment) ==
|
||||
|
||||
After some time, we lose the fresh view of newcomers. Just providing your feedback helps us a lot.
|
||||
|
||||
Browse our websites and documentation and play with !FreedomBox and comment your impressions on the [[https://discuss.freedombox.org/c/feedback/2|feedback section of our forum]].
|
||||
|
||||
|
||||
== Request applications ==
|
||||
|
||||
Check our [[https://wiki.debian.org/FreedomBox/LeavingTheCloud|applications wishlist]] and help us extend it by searching the web for other interesting free software to include in !FreedomBox.
|
||||
|
||||
|
||||
== Translate ==
|
||||
|
||||
All text visible to users of !FreedomBox needs to be localized to various languages. If you know english and speak another language you can contribute translating. Translating is a nice way to get familiar with the project while contributing.
|
||||
|
||||
This translation work includes:
|
||||
|
||||
* [[FreedomBox/Plinth|Web Interface]] of !FreedomBox
|
||||
* !FreedomBox documentation, including the !FreedomBox [[FreedomBox|wiki]]
|
||||
* !FreedomBox [[https://freedombox.org|website]] and [[https://freedomboxfoundation.org|foundation website]].
|
||||
* [[https://docs.djangoproject.com/en/dev/internals/contributing/localizing/|Django web framework]] that !FreedomBox uses.
|
||||
* Individual [[https://wiki.debian.org/FreedomBox/Manual/#Apps|applications]] that !FreedomBox exposes to users.
|
||||
|
||||
The localization of !FreedomBox web interface happens mainly on the web-based tool at [[https://hosted.weblate.org/projects/freedombox/|Weblate]].
|
||||
|
||||
If you wish to see !FreedomBox available for one of your languages, please start a discussion on the !FreedomBox discussion forum's [[https://discuss.freedombox.org/c/development|development category]] to work with others translating for that language.
|
||||
|
||||
For more information, please visit the !FreedomBox [[FreedomBox/Translate|translators]] page.
|
||||
|
||||
|
||||
== Document: User Manual, Website and Wiki ==
|
||||
|
||||
!FreedomBox needs better documentation for users and contributors. Sometimes, just rewording or presenting the information another way, already helps. Others, a certain knowledge is needed.
|
||||
|
||||
!FreedomBox manual is prepared by aggregating various pages on the wiki and exporting to various formats. The manual is then used in !FreedomBox Service and elsewhere.
|
||||
|
||||
If you wish to contribute to the !FreedomBox [[FreedomBox|wiki]] (and consequently the !FreedomBox manual), you can create a wiki account and start editing.
|
||||
|
||||
For contributing to the website please start a discussion on the !FreedomBox discussion forum's [[https://discuss.freedombox.org/c/development|development category]].
|
||||
|
||||
|
||||
== Assure Quality (Test and Check) ==
|
||||
|
||||
* !FreedomBox already runs on many platforms and it is not possible for developers to test all possible platforms. If you have one of the supported hardware you can help with testing !FreedomBox on the platform.
|
||||
|
||||
* When an application is made available on !FreedomBox, not all of its functionality is tested in the real world by developer doing the work. Deploying the application and testing it will help ensure high quality applications in !FreedomBox.
|
||||
|
||||
See the [[FreedomBox/QualityAssurance|quality assurance]] page for a basic list of test cases to check for and information on reporting bugs.
|
||||
|
||||
|
||||
== Code ==
|
||||
|
||||
If you are a developer, you can contribute code to one of the sub-projects of !FreedomBox. Step-by-step process of [[/Code|contributing code]] to !FreedomBox is available.
|
||||
|
||||
* [[FreedomBox/Plinth|FreedomBox Service]]: a web interface to administer the functions of !FreedomBox.
|
||||
* [[FreedomBox/Maker|Freedom Maker]]: a script to build !FreedomBox disk images for use on various hardware devices or virtual machines.
|
||||
|
||||
You can pickup a task from one of the [[FreedomBox/TODO|TODO]] lists. The individual page project pages contain information availabily of the code, how to build and TODO lists.
|
||||
You can pick up a task from one of the [[FreedomBox/TODO|TODO]] lists. The individual page project pages contain information availabily of the code, how to build and TODO lists.
|
||||
|
||||
=== Design ===
|
||||
=== Fix Bugs ===
|
||||
|
||||
==== User Experience Design ====
|
||||
List of bugs, feature requests and improvements are tracked on the !FreedomBox [[https://salsa.debian.org/freedombox-team/freedombox/issues/|issue tracker]]. In addition to that, see [[FreedomBox/Contribute/Bugs|list of bugs]] to help out the Debian package we depend on. Also see the !FreedomBox [[https://qa.debian.org/developer.php?login=freedombox-pkg-team%40lists.alioth.debian.org&comaint=yes|packaging team's dashboard]] for status of various packages that we use.
|
||||
|
||||
=== Add an Application ===
|
||||
|
||||
If you are a developer and wish to see an application available in !FreedomBox, you can contribute by adding the application to !FreedomBox. See the [[https://docs.freedombox.org/|FreedomBox Developer Manual]]. Many applications that can be added to !FreedomBox have been identified on the [[FreedomBox/LeavingTheCloud|leaving the cloud]] page.
|
||||
|
||||
=== Development priorities ===
|
||||
|
||||
Upcoming priorities are discussed on an regular basis. You find the progress of the !FreedomBox Service with its priorities here: [[https://salsa.debian.org/groups/freedombox-team/-/boards|issues board]] and [[https://salsa.debian.org/groups/freedombox-team/-/milestones|milestones]].
|
||||
|
||||
Please check next [[FreedomBox/ProgressCalls|progress calls]] to keep yourself on track and meet members of the release team. A [[FreedomBox/TODO|TODO page]] aggregates the complete list of the items to work on for !FreedomBox.
|
||||
|
||||
== Design ==
|
||||
|
||||
=== User Experience Design ===
|
||||
|
||||
If you are a user experience designer, you can help !FreedomBox with the following items:
|
||||
|
||||
@ -61,51 +133,16 @@ If you are a user experience designer, you can help !FreedomBox with the followi
|
||||
* Possible designs for custom !FreedomBox cases on single board computers
|
||||
* [[../Design|User experience design]]
|
||||
|
||||
==== Technical Design ====
|
||||
=== Technical Design ===
|
||||
|
||||
!FreedomBox needs your technical expertise to devise implementation plans for upcoming features. You can contribute to the discussion on various technical design and implementation aspects of !FreedomBox. See !FreedomBox discussion forum's [[https://discuss.freedombox.org/c/development|development category]].
|
||||
!FreedomBox needs your technical expertise to devise implementation plans for upcoming features. You can contribute to the discussion on various technical design and implementation aspects of !FreedomBox. See !FreedomBox discussion forum's [[https://discuss.freedombox.org/c/development|development category]].
|
||||
|
||||
=== Donate ===
|
||||
|
||||
The [[https://freedomboxfoundation.org|FreedomBox Foundation]] is a 501(c)(3) federal nonprofit corporation with recognition from the IRS. !FreedomBox project is run by volunteers. You can help the project financially by donating via !PayPal, Bitcoin or by mailing a check. Please see the [[https://www.freedomboxfoundation.org/donate/|donation page]] for details on how to donate.
|
||||
== Package Applications ==
|
||||
|
||||
=== Document: User Manual, Website and Wiki ===
|
||||
!FreedomBox is a Debian Pure Blend. In order to add applications to !FreedomBox we need applications first to be Debian-packaged. Check our [[https://wiki.debian.org/FreedomBox/LeavingTheCloud|applications wishlist]].
|
||||
|
||||
!FreedomBox needs better documentation for users and contributors. !FreedomBox manual is prepared by aggregating various pages on the wiki and exporting to various formats. The manual is then used in !FreedomBox Service and elsewhere.
|
||||
|
||||
If you wish to contribute to the !FreedomBox [[FreedomBox|wiki]] (and consequently the !FreedomBox manual), you can create a wiki account and start editing.
|
||||
|
||||
For contributing to the website please start a discussion on the !FreedomBox discussion forum's [[https://discuss.freedombox.org/c/development|development category]].
|
||||
|
||||
=== Quality Assurance ===
|
||||
|
||||
* !FreedomBox already runs on many platforms and it is not possible for developers to test all possible platforms. If you have one of the supported hardware you can help with testing !FreedomBox on the platform.
|
||||
|
||||
* When an application is made available on !FreedomBox, not all of its functionality is tested in the real world by developer doing the work. Deploying the application and testing it will help ensure high quality applications in !FreedomBox.
|
||||
|
||||
See the [[FreedomBox/QualityAssurance|quality assurance]] page for a basic list of test cases to check for and information on reporting bugs.
|
||||
|
||||
=== Localization ===
|
||||
|
||||
All text visible to users of !FreedomBox needs to be localized to various languages. This translation work includes:
|
||||
|
||||
* [[FreedomBox/Plinth|Web Interface]] for !FreedomBox
|
||||
* !FreedomBox documentation
|
||||
* !FreedomBox [[FreedomBox|wiki]], [[https://freedombox.org|website]] and [[https://freedomboxfoundation.org|foundation website]].
|
||||
* [[https://docs.djangoproject.com/en/dev/internals/contributing/localizing/|Django web framework]] that !FreedomBox uses.
|
||||
* Individual applications that !FreedomBox exposes to users.
|
||||
|
||||
You can contribute to the localization effort using the web-based tool at [[https://hosted.weblate.org/projects/freedombox/|Weblate]] or directly to the source tree via [[https://salsa.debian.org/freedombox-team/freedombox/tree/master/plinth/locale|Salsa]].
|
||||
|
||||
If you wish to see !FreedomBox available for one of your languages, please start a discussion on the !FreedomBox discussion forum's [[https://discuss.freedombox.org/c/development|development category]] to work with others translating for that language.
|
||||
|
||||
For more information, please visit the !FreedomBox [[FreedomBox/Translate|translators]] page.
|
||||
|
||||
=== Spread the Word ===
|
||||
|
||||
Speak to your family, friends, local community or at global conferences about
|
||||
the importance of !FreedomBox. To be a successful project we need many more
|
||||
participants, be it users or contributors. Write about your efforts at the [[https://www.freedomboxfoundation.org/appearances/index.en.html|talks page]] and on the [[FreedomBox/TalksAndPresentations|wiki]].
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
|
||||
@ -14,8 +14,8 @@
|
||||
'''Available since''': version 0.14.0
|
||||
|
||||
=== What is Matrix? ===
|
||||
[[https://matrix.org/|Matrix]] is an open standard for interoperable, decentralized, real-time communication over IP. Synapse is the reference implementation of a Matrix server. It can be used to setup instant messaging on !FreedomBox to host large chat rooms, end-to-end encrypted communication and audio/video calls.
|
||||
Matrix Synapse is a federated application where chat rooms can exist on any server and users from any server in the federated network can join them. [[https://matrix.org/docs/guides/faq.html|Learn more]] about Matrix.
|
||||
[[https://matrix.org/|Matrix]] is an open protocol for interoperable, decentralized, real-time communication over IP. Synapse is the reference implementation of a Matrix server. It can be used to setup instant messaging on !FreedomBox to host chat rooms with end-to-end encrypted communication and audio/video calls.
|
||||
Matrix Synapse is a federated application where chat rooms can exist on any server and users from any server in the federated network can join them. [[https://matrix.org/docs/guides/faq.html|Learn more]] about Matrix.
|
||||
|
||||
=== How to access your Matrix Synapse server? ===
|
||||
|
||||
@ -28,13 +28,19 @@ If your !FreedomBox is behind a router, you will need to set up port forwarding
|
||||
|
||||
=== Setting up Matrix Synapse on your FreedomBox ===
|
||||
|
||||
To enable Matrix, first navigate to the Chat Server (Matrix Synapse) page and install it. Matrix needs a valid domain name to be configured. After installation, you will be asked to configure it. You will be able to select a domain from a drop down menu of available domains. Domains are configured using [[FreedomBox/Manual/Configure|System -> Configure page]]. After configuring a domain, you will see that the service is running. The service will be accessible on the configured !FreedomBox domain. Currently, you will not be able to change the domain once is it configured.
|
||||
To enable Matrix Synapse, first navigate to the Chat Server (Matrix Synapse) page and install it. Matrix needs a valid domain name to be configured. After installation, you will be asked to configure it. You will be able to select a domain from a drop down menu of available domains. Domains are configured using [[FreedomBox/Manual/Configure|System -> Configure]] page. After configuring a domain, you will see that the service is running. The service will be accessible on the configured !FreedomBox domain. Currently, you will not be able to change the domain once is it configured.
|
||||
|
||||
Your router has to be configured to forward port 8448.
|
||||
|
||||
All the registered users of your !FreedomBox will have their Matrix IDs as `@username:domain`. If public registration is enabled, also your chosen client can be used to register a user account.
|
||||
|
||||
If your !FreedomBox is behind a router (NAT) you might need [[FreedomBox/Manual/Coturn|Coturn]] for Voice over IP calls.
|
||||
=== Setting up Audio/Video calls ===
|
||||
|
||||
The Matrix Synapse server is only responsible for establishing calls between participants in rooms. Matrix clients such as Element are actually responsible for the transfer of the audio/video traffic. Element supports calling in both one-to-one conversations and in groups.
|
||||
|
||||
For one-to-one conversations, Element tries to make a peer-to-peer connection between the two participants. This works when both the participants are using Element on computers with a public IP address or if they're on the same network. If both the participants are behind different NAT devices, establishing a direct peer-to-peer connection between them will not be possible. This problem can be solved by configuring Matrix Synapse with a STUN/TURN server. !FreedomBox provides an app called [[FreedomBox/Manual/Coturn|Coturn]] for this purpose. !FreedomBox doesn't automatically install Coturn on installing Matrix Synapse. However, as soon as Coturn app is installed, !FreedomBox automatically configures Matrix Synapse to use it for audio/video calls. It is possible to override this configuration with a different STUN/TURN server in the web interface.
|
||||
|
||||
For calling groups with more than two participants (i.e. not one-on-one conversations), Element uses an external Jitsi Meet instance. Element uses jitsi.riot.im as its default Jitsi Meet instance. If the Matrix Synapse server is configured to use a different Jitsi Meet instance as the default, Element will use it instead for all users on that server.
|
||||
|
||||
=== Federating with other Matrix instances ===
|
||||
|
||||
|
||||
@ -10,6 +10,17 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
|
||||
|
||||
The following are the release notes for each !FreedomBox version.
|
||||
|
||||
== FreedomBox 21.4.2 (2021-03-28) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
* firstboot: Use session to verify first boot welcome step
|
||||
|
||||
=== Other Changes ===
|
||||
|
||||
* locale: Update translations for German, Greek, Indonesian, Turkish
|
||||
* manual: Update Contributing and Matrix Synapse pages
|
||||
|
||||
== FreedomBox 21.4.1 (2021-03-13) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
@ -24,7 +24,7 @@ An alternative to downloading these images is to [[InstallingDebianOn|install De
|
||||
=== Hardware ===
|
||||
|
||||
* Open Source Hardware (OSHW): No
|
||||
* CPU: Rockchip RK3328 Quad-Core SOC (4x Cortex A53@1.5Ghz)
|
||||
* CPU: Rockchip RK3328 Quad-Core SOC (4x Cortex A53 @ 1.5Ghz)
|
||||
* GPU: Mali 450MP2
|
||||
* RAM: 1 GiB or 2 GiB or 4 GiB LPDDR3
|
||||
* Storage: eMMC module slot, microSD slot, 16 MiB SPI Flash
|
||||
|
||||
@ -23,23 +23,83 @@ Desde la codificación, el diseño y la traducción hasta la divulgación y las
|
||||
|
||||
Como nuevo contribuyente, eres más que bienvenido a presentarte a otros en el [[https://discuss.freedombox.org/c/development|foro de debate]], la [[http://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss|lista de correo]] o el [[irc://irc.debian.org/freedombox|canal de IRC]] de !FreedomBox. Además de hacer contactos útiles, puedes empezar a informar fallos y traducir (ver abajo) el wiki y el interfaz de !FreedomBox.
|
||||
|
||||
== Prioridades de Desarrollo ==
|
||||
|
||||
Las prioridades se discuten regularmente. Encontrarás el avance del Servicio !FreedomBox con sus prioridades aquí: [[https://salsa.debian.org/groups/freedombox-team/-/boards|panel de tareas]] e [[https://salsa.debian.org/groups/freedombox-team/-/milestones|hitos]].
|
||||
|
||||
Por favor, asiste a las próximas [[FreedomBox/ProgressCalls|reuniones de avance]] para mantenerte al día y tratar con los miembros del equipo de publicación (release). La [[FreedomBox/TODO|Página de trabajos pendientes]] recopila la lista completa de los elementos en los que trabajar para !FreedomBox.
|
||||
= Se necesitan contribuciones =
|
||||
|
||||
== Se necesitan Contribuciones ==
|
||||
Ordenadas por dificultad ascencente.
|
||||
|
||||
=== Añadir una Aplicación ===
|
||||
== Donar ==
|
||||
|
||||
Si eres desarrollador y quieres ver disponible en !FreedomBox alguna aplicación, puedes contribuir añadiéndola a !FreedomBox. Mira el [[https://docs.freedombox.org/|Manual del Desarrollador de FreedomBox]].
|
||||
Obviamente donar es la manera más fácil de contribuir.
|
||||
|
||||
=== Defectos ===
|
||||
Puedes ayudar a su financiación donando mediante !PayPal, Bitcoin o enviando un cheque. Mira por favor la [[https://www.freedomboxfoundation.org/donate/|página de donación]] para más detalles acerca de cómo donar.
|
||||
|
||||
Las listas de defectos, peticiones de funcionalidad y mejoras se controlan en el [[https://salsa.debian.org/freedombox-team/freedombox/issues/|gestor de tiquets]] de !FreedomBox. Mira también la [[FreedomBox/Contribute/Bugs|lista de defectos]] para ayudar al paquete Debian del que dependemos y el [[https://qa.debian.org/developer.php?login=freedombox-pkg-team%40lists.alioth.debian.org&comaint=yes|cuadro de mando del equipo de paquetizado]] de !FreedomBox para ver el estado los paquetes que usamos.
|
||||
El proyecto !FreedomBox lo llevan voluntarios. La ''[[https://freedomboxfoundation.org|FreedomBox Foundation]]'' es una corporación federal 501(c)(3) reconocida por el IRS.
|
||||
|
||||
=== Codificar ===
|
||||
|
||||
== Correr la voz ==
|
||||
|
||||
Correr la voz acerca de !FreedomBox solo requiere saber acerca de los objetivos básicos del proyecto y una descripción general del producto.
|
||||
|
||||
Cuenta a tu familia, amistades, comunidad local o en conferencias globales la importancia de !FreedomBox. Para ser un proyecto exitoso necesitamos muchos más
|
||||
participantes, ya sean usuarios o contribuyentes. Comenta tus esfuerzos de divulgación en la [[https://www.freedomboxfoundation.org/appearances/index.en.html|página de charlas]] y en el [[FreedomBox/TalksAndPresentations|wiki]].
|
||||
|
||||
Si sabes algo de márketing, puedes ponerte en contacto con el equipo de marketing mediante la [[https://discuss.freedombox.org/c/community/marketing/14|sección de ''Marketing'' de nuestro foro]].
|
||||
|
||||
|
||||
== Darnos tus impresiones (Comentar) ==
|
||||
|
||||
Tras cierto tiempo perdemos la visión fresca de quienes acaban de llegar. Solo con hacernos llegar tus impresiones ya nos ayudas un montón.
|
||||
|
||||
Navega por nuestros sitios web y por la documentación, y juega con !FreedomBox y comenta tus impresiones en la [[https://discuss.freedombox.org/c/feedback/2|sección de ''Feedback'' de nuestro foro]].
|
||||
|
||||
|
||||
== Pedir aplicaciones ==
|
||||
|
||||
Mira nuestra [[https://wiki.debian.org/FreedomBox/LeavingTheCloud|lista de aplicaciones deseadas]] y ayúdanos a extenderla buscando en la web otras aplicaciones de software libre para incluír en !FreedomBox.
|
||||
|
||||
|
||||
== Traducir ==
|
||||
|
||||
Todo texto visible por los usuarios de !FreedomBox necesita ser localizado a varios idiomas. Si entiendes inglés y escribes otro idioma puedes contribuír traduciendo. Traducir es una forma estupenda de familiarizarse con el proyecto mientras contribuyes.
|
||||
|
||||
Este trabajo de traducción incluye:
|
||||
|
||||
* El [[FreedomBox/Plinth|Interfaz web]] de !FreedomBox.
|
||||
* La documentación de !FreedomBox, incluyendo el [[es/FreedomBox|wiki]].
|
||||
* Los sitios web de [[https://freedombox.org|FreedomBox]] y la ''[[https://freedomboxfoundation.org|Freedombox Foundation]]''.
|
||||
* El [[https://docs.djangoproject.com/en/dev/internals/contributing/localizing/|framework Django]] que emplea !FreedomBox.
|
||||
* Cada [[es/FreedomBox/Manual#Apps|aplicación]] que !FreedomBox expone a sus usuarios.
|
||||
|
||||
La localización del interfaz web de !FreedomBox ocurre principalmente en la herramienta web [[https://hosted.weblate.org/projects/freedombox/|Weblate]].
|
||||
|
||||
Si quieres ver a !FreedomBox disponible en alguno de tus idiomas, por favor abre un debate en la [[https://discuss.freedombox.org/c/development|sección de desarrollo]] del foro de !FreedomBox para trabajar con otros traduciendo para ese idioma.
|
||||
|
||||
Para más información, por favor visita la página de [[FreedomBox/Translate|traductores]].
|
||||
|
||||
|
||||
== Documentar: Manual de Usuario, Sitio Web y Wiki ==
|
||||
|
||||
!FreedomBox necesita mejor documentación para usuarios y contribuyentes. A veces re-redactar o presentar la información de otra manera ya ayuda. Otras se necesita cierto conocimiento.
|
||||
|
||||
El manual de !FreedomBox se prepara agregando diferentes páginas del wiki y exportando a various formatos. El manual se usa en el Servicio !FreedomBox y en otros sitios.
|
||||
|
||||
Si quieres contribuir al [[es/FreedomBox|wiki]] (y por extensión al manual) de !FreedomBox, puedes crear una cuenta en el wiki y empezar a editar.
|
||||
|
||||
Para contribuir al sitio web por favor inicia un debate en la [[https://discuss.freedombox.org/c/development|sección de desarrollo]] del foro de !FreedomBox.
|
||||
|
||||
|
||||
== Asegurar la calidad (probar y comprobar) ==
|
||||
|
||||
* !FreedomBox ya funciona sobre muchas plataformas y a los desarrolladores les resulta imposible probar en todas. Si tienes algún hardware soportado puedes ayudar probando !FreedomBox en tu platforma.
|
||||
|
||||
* Cuando se integra una nueva aplicación en !FreedomBox, el desarrollador que hace el trabajo no prueba toda la functionalidad en el mundo real. Desplegar la aplicación y probarla ayudará a tener aplicaciones de alta calidad en !FreedomBox.
|
||||
|
||||
Mira en la página de [[FreedomBox/QualityAssurance|aseguramiento de la calidad]] la lista de casos de prueba que hay que verificar y la información acerca de cómo informar defectos.
|
||||
|
||||
|
||||
== Codificar ==
|
||||
|
||||
Si eres desarrollador puedes contribuir código a algún sub-proyecto de !FreedomBox. Éste es el procedimiento paso a paso para [[FreedomBox/Contribute/Code|contribuir código]].
|
||||
|
||||
@ -48,9 +108,24 @@ Si eres desarrollador puedes contribuir código a algún sub-proyecto de !Freedo
|
||||
|
||||
Puedes tomar una tarea de la [[FreedomBox/TODO|Página de trabajos pendientes]]. Las páginas de cada proyecto contienen información acerca de acceso al código, cómo construir y listas de trabajos pendientes.
|
||||
|
||||
=== Diseño ===
|
||||
=== Arreglar defectos ===
|
||||
|
||||
==== Diseño de Experiencia de Usuario (UX) ====
|
||||
Las listas de defectos, peticiones de funcionalidad y mejoras se controlan en el [[https://salsa.debian.org/freedombox-team/freedombox/issues/|gestor de tiquets]] de !FreedomBox. Mira también la [[FreedomBox/Contribute/Bugs|lista de defectos]] para ayudar al paquete Debian del que dependemos y el [[https://qa.debian.org/developer.php?login=freedombox-pkg-team%40lists.alioth.debian.org&comaint=yes|cuadro de mando del equipo de paquetizado]] de !FreedomBox para ver el estado los paquetes que usamos.
|
||||
|
||||
=== Añadir una aplicación ===
|
||||
|
||||
Si eres desarrollador y quieres ver disponible en !FreedomBox alguna aplicación, puedes contribuir añadiéndola a !FreedomBox. Mira el [[https://docs.freedombox.org/|Manual del Desarrollador de FreedomBox]].
|
||||
|
||||
=== Prioridades de desarrollo ===
|
||||
|
||||
Las prioridades se discuten regularmente. Encontrarás el avance del Servicio !FreedomBox con sus prioridades aquí: [[https://salsa.debian.org/groups/freedombox-team/-/boards|panel de tareas]] e [[https://salsa.debian.org/groups/freedombox-team/-/milestones|hitos]].
|
||||
|
||||
Por favor, asiste a las próximas [[FreedomBox/ProgressCalls|reuniones de avance]] para mantenerte al día y tratar con los miembros del equipo de publicación (release). La [[FreedomBox/TODO|Página de trabajos pendientes]] recopila la lista completa de los elementos en los que trabajar para !FreedomBox.
|
||||
|
||||
|
||||
== Diseño ==
|
||||
|
||||
=== Diseño de Experiencia de Usuario (UX) ===
|
||||
|
||||
Si eres diseñador de UX, puedes ayudar a !FreedomBox con esto:
|
||||
|
||||
@ -60,51 +135,16 @@ Si eres diseñador de UX, puedes ayudar a !FreedomBox con esto:
|
||||
* Propuestas de diseño para casos de uso de !FreedomBox sobre SBCs personalizados.
|
||||
* [[FreedomBox/Design|Diseño de UX]]
|
||||
|
||||
==== Diseño Técnico ====
|
||||
=== Diseño Técnico ===
|
||||
|
||||
!FreedomBox necesita tu conocimiento técnico para elaborar planes de implementación de nuevas funcionalidades. Puedes contribuir a los debates acerca de varios aspectos de diseño técnico e implementación de !FreedomBox. Mira la [[https://discuss.freedombox.org/c/development|sección de desarrollo]] de los foros de discusión.
|
||||
!FreedomBox necesita tu conocimiento técnico para elaborar planes de implementación de nuevas funcionalidades. Puedes contribuir a los debates acerca de varios aspectos de diseño técnico e implementación de !FreedomBox. Mira la [[https://discuss.freedombox.org/c/development|sección de Desarrollo]] de los foros de debate.
|
||||
|
||||
=== Donar ===
|
||||
|
||||
La ''[[https://freedomboxfoundation.org|FreedomBox Foundation]]'' es una corporación federal 501(c)(3) reconocida por el IRS. El proyecto !FreedomBox lo llevan voluntarios. Puedes ayudar a su financiación donando mediante !PayPal, Bitcoin o enviando un cheque. Mira por favor la [[https://www.freedomboxfoundation.org/donate/|página de donación]] para más detalles acerca de cómo donar.
|
||||
== Empaquetar aplicaciones ==
|
||||
|
||||
=== Documentar: Manual de Usuario, Sitio Web y Wiki ===
|
||||
|
||||
!FreedomBox necesita mejor documentación para usuarios y contribuyentes. El manual de !FreedomBox se prepara agregando diferentes páginas del wiki y exportando a various formatos. El manual se usa en el Servicio !FreedomBox y en otros sitios.
|
||||
|
||||
Si quieres contribuir al [[FreedomBox|wiki]] (y por extensión al manual) de !FreedomBox, puedes crear una cuenta en el wiki y empezar a editar.
|
||||
|
||||
Para contribuir al sitio web por favor inicia un debate en la [[https://discuss.freedombox.org/c/development|sección de desarrollo]] del foro de !FreedomBox.
|
||||
|
||||
=== Asegurar la Calidad ===
|
||||
|
||||
* !FreedomBox ya funciona sobre muchas plataformas y a los desarrolladores les resulta imposible probar en todas. Si tienes algún hardware soportado puedes ayudar probando !FreedomBox en tu platforma.
|
||||
|
||||
* Cuando se integra una nueva aplicación en !FreedomBox, el desarrollador que hace el trabajo no prueba toda la functionalidad en el mundo real. Desplegar la aplicación y probarla ayudará a tener aplicaciones de alta calidad en !FreedomBox.
|
||||
|
||||
Mira en la página de [[FreedomBox/QualityAssurance|aseguramiento de la calidad]] la lista de casos de prueba que hay que verificar y la información acerca de cómo informar defectos.
|
||||
|
||||
=== Localizar (l10n) ===
|
||||
|
||||
Todo texto visible por los usuarios de !FreedomBox necesita ser localizado a varios idiomas. Este trabajo de traducción incluye:
|
||||
|
||||
* El [[FreedomBox/Plinth|Interfaz web]] de !FreedomBox
|
||||
* La documentación de !FreedomBox
|
||||
* El [[FreedomBox|wiki]] y los sitios web de [[https://freedombox.org|FreedomBox]] y la ''[[https://freedomboxfoundation.org|Freedombox Foundation]]''.
|
||||
* El [[https://docs.djangoproject.com/en/dev/internals/contributing/localizing/|framework Django]] que emplea !FreedomBox.
|
||||
* Cada aplicación que !FreedomBox expone a sus usuarios.
|
||||
|
||||
Puedes contribuir al esfuerzo de localización usando la herramienta web [[https://hosted.weblate.org/projects/freedombox/|Weblate]] o directamente en el repositorio de código mediante [[https://salsa.debian.org/freedombox-team/freedombox/tree/master/plinth/locale|Salsa]].
|
||||
|
||||
Si quieres ver a !FreedomBox disponible en alguno de tus idiomas, por favor abre un debate en la [[https://discuss.freedombox.org/c/development|sección de desarrollo]] del foro de !FreedomBox para trabajar con otros traduciendo para ese idioma.
|
||||
|
||||
Para más información, por favor visita la página de [[FreedomBox/Translate|traductores]].
|
||||
|
||||
=== Correr la Voz ===
|
||||
|
||||
Cuenta a tu familia, amistades, comunidad local o en conferencias globales la importancia de !FreedomBox. Para ser un proyecto exitoso necesitamos muchos más
|
||||
participantes, ya sean usuarios o contribuyentes. Comenta tus esfuerzos de divulgación en la [[https://www.freedomboxfoundation.org/appearances/index.en.html|página de charlas]] y en el [[FreedomBox/TalksAndPresentations|wiki]].
|
||||
!FreedomBox es una ''variante pura'' de Debian. Para añadir aplicaciones a !FreedomBox necesitames primero que estén empaquetadas para Debian. Mira nuestra [[https://wiki.debian.org/FreedomBox/LeavingTheCloud|lista de aplicaciones deseadas]].
|
||||
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
<<Include(es/FreedomBox/Portal)>>
|
||||
|
||||
@ -12,8 +12,8 @@
|
||||
'''Disponible desde:''' versión 0.14.0
|
||||
|
||||
=== ¿Qué es Matrix? ===
|
||||
[[https://matrix.org/|Matrix]] es un estándar abierto para comunicaciones sobre IP en tiempo real interoperables y descentralizadas. ''Synapse'' es la implementación de referencia de un servidor Matrix. Se puede usar para montar mensajería instantánea sobre !FreedomBox para albergar grandes salones de chat, comunicaciones cifradas punto a punto y llamadas de audio/vídeo.
|
||||
Matrix Synapse es una aplicación federada en la que puede haber salas de chat en un servidor y los usuarios de cualquier otro servidor de la red federada pueden unirse a ellas. [[https://matrix.org/docs/guides/faq.html|Más información]] acerca de Matrix.
|
||||
[[https://matrix.org/|Matrix]] es un protocolo abierto para comunicaciones sobre IP en tiempo real interoperables y descentralizadas. ''Synapse'' es la implementación de referencia de un servidor Matrix. Se puede usar para montar mensajería instantánea sobre !FreedomBox para albergar salas de chat con comunicaciones cifradas punto a punto y llamadas de audio/vídeo.
|
||||
Matrix Synapse es una aplicación federada en la que puede haber salas de chat en un servidor y los usuarios de cualquier otro servidor de la red federada pueden unirse a ellas. [[https://matrix.org/docs/guides/faq.html|Más información]] acerca de Matrix.
|
||||
|
||||
=== ¿Cómo acceder a tu servidor Matrix Synapse? ===
|
||||
|
||||
@ -21,13 +21,19 @@ Para acceder al servidor Matrix Synapse recomendamos el cliente [[https://elemen
|
||||
|
||||
=== Configurar Matrix Synapse en tu FreedomBox ===
|
||||
|
||||
Para habilitar Matrix, primero navega a la página de tu servidor de chat (Matrix Synapse) e instálalo. Matrix necesita un nombre de dominio válido configurado. Tras la instalación, se te pedirá que lo configures seleccionandolo de entre un menú desplegable con dominios disponibles. Los dominios se configuran en la página [[es/FreedomBox/Manual/Configure|Sistema -> Configuración]] y '''actualmente no podrás cambiar el dominio''' una vez esté configurado. Tras configurar un dominio verás que el servicio se está ejecutando. El servicio estará accesible en el dominio de !FreedomBox configurado.
|
||||
Para habilitar Matrix Synapse, primero navega a la página de tu servidor de chat (Matrix Synapse) e instálalo. Matrix necesita un nombre de dominio válido configurado. Tras la instalación, se te pedirá que lo configures seleccionandolo de entre un menú desplegable con dominios disponibles. Los dominios se configuran en la página [[es/FreedomBox/Manual/Configure| Sistema -> Configuración]] y '''actualmente no podrás cambiar el dominio''' una vez esté configurado. Tras configurar un dominio verás que el servicio se está ejecutando. El servicio estará accesible en el dominio de !FreedomBox configurado.
|
||||
|
||||
Tendrás que configurar tu router para que reenvíe el puerto 8448 a tu !FreedomBox.
|
||||
|
||||
Todos los usuarios registrados en tu !FreedomBox tendrán sus IDs Matrix `@usuario:dominio`. Si está habilitado el registro público tu cliente se puede usar también para registrar una cuenta de usuario nueva.
|
||||
|
||||
Si tu !FreedomBox está detrás de un router (NAT), quizá necesites [[es/FreedomBox/Manual/Coturn|Coturn]] para hacer llamadas de voz sobre IP.
|
||||
=== Configurar llamadas de audio/vídeo ===
|
||||
|
||||
El servidor Matrix Synapse solo es responsable de establecer las conexiones entre los participantes de la sala. Los clientes Matrix como Element son los responsables de transmitir el audio/vídeo. Element soporta tanto llamadas individuales como de grupo.
|
||||
|
||||
Para conversaciones individuales, Element intenta establecer una conexión directa entre ambos participantes. Esto funciona cuando ambos participantes están empleando Element en máquinas con una IP pública o si están en la misma red (local). Si ambos participantes están detrás de diferentes NATs no será posible establecer una conexión directa entre ellos. Esta dificultad se resuelve configurando Matrix Synapse contra un servidor STUN/TURN. !FreedomBox proporciona una app llamada [[es/FreedomBox/Manual/Coturn|Coturn]] para este propósito. !FreedomBox no instala Coturn automaticamente al instalar Matrix Synapse. No obstante, en cuanto se instala la app Coturn !FreedomBox automáticamente reconfigura Matrix Synapse para usarla en llamadas de audio/vídeo. Se puede ajustar esta configuración en la interfaz web para emplear otro servidor STUN/TURN.
|
||||
|
||||
Para llamadas de grupo Element emplea una instancia de Jitsi Meet externa; por omisión, `jitsi.riot.im`. Si se configura el servidor Matrix Synapse para usar una instancia Jitsi Meet diferente Element la usará para todos los usuarios del servidor.
|
||||
|
||||
=== Federarse con otras instancias Matrix ===
|
||||
|
||||
|
||||
@ -10,6 +10,17 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
|
||||
|
||||
The following are the release notes for each !FreedomBox version.
|
||||
|
||||
== FreedomBox 21.4.2 (2021-03-28) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
* firstboot: Use session to verify first boot welcome step
|
||||
|
||||
=== Other Changes ===
|
||||
|
||||
* locale: Update translations for German, Greek, Indonesian, Turkish
|
||||
* manual: Update Contributing and Matrix Synapse pages
|
||||
|
||||
== FreedomBox 21.4.1 (2021-03-13) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
@ -24,7 +24,7 @@ An alternative to downloading these images is to [[InstallingDebianOn|install De
|
||||
=== Hardware ===
|
||||
|
||||
* Open Source Hardware (OSHW): No
|
||||
* CPU: Rockchip RK3328 Quad-Core SOC (4x Cortex A53@1.5Ghz)
|
||||
* CPU: Rockchip RK3328 Quad-Core SOC (4x Cortex A53 @ 1.5Ghz)
|
||||
* GPU: Mali 450MP2
|
||||
* RAM: 1 GiB or 2 GiB or 4 GiB LPDDR3
|
||||
* Storage: eMMC module slot, microSD slot, 16 MiB SPI Flash
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user