Skip to content

Commit 330bc8d

Browse files
committed
Add whitespace around custom containers
This lets them be properly parsed by crowdin
1 parent dd604d7 commit 330bc8d

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

70 files changed

+310
-82
lines changed

docs/bugs.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
# Reporting Bugs
22

33
::: danger Security Vulnerabilities
4+
45
If you discover a security vulnerability within Flarum, please send an email to [security@flarum.org](mailto:security@flarum.org) so we can address it promptly.
6+
57
:::
68

79
Thank you for helping us test Flarum. We're happy to have you on the team! We need people who can *troubleshoot issues patiently* and *communicate them clearly*. As you probably know, good bug reporting takes some time and effort. If you're fine with that, then let's get started!

docs/composer.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,9 @@ You'll need to use composer if you want to:
1010
This guide is provided as a brief explanation of Composer. We highly recommend consulting the [official documentation](https://getcomposer.org/doc/00-intro.md) for more information.
1111

1212
::: tip Composer v2
13+
1314
Historically, Composer has caused issues on shared hosting due to huge memory use. In 2020, [Composer v2 was released](https://blog.packagist.com/composer-2-0-is-now-available/) with massive performance and memory usage improvements that eliminate these problems. Make sure your server is using Composer v2!
15+
1416
:::
1517

1618
## What is Composer?
@@ -139,7 +141,9 @@ In this case you can install composer as recommended in the Composer [guide]([ht
139141
If Composer is not preinstalled (you can check this by running `composer --version`), you can use a [manual installation](https://getcomposer.org/composer-stable.phar). Just upload the composer.phar to your folder and run `/path/to/your/php7 composer.phar COMMAND` for any command documented as `composer COMMAND`.
140142

141143
::: danger
144+
142145
Some articles on the internet will mention that you can use tools like a PHP shell. If you are not sure what you are doing or what they are talking about - be careful! An unprotected web shell is **extremely** dangerous.
146+
143147
:::
144148

145149
## How do I use Composer?
@@ -149,7 +153,9 @@ You'll need to use Composer over the **C**ommand-**l**ine **i**nterface (CLI).
149153
Once you have Composer installed, you should be able to run Composer commands in your SSH terminal via `composer COMMAND`.
150154

151155
::: Optimizations
156+
152157
After most commands, you'll want to run `composer dump-autoload -a`. Essentially, this caches PHP files so they run faster.
158+
153159
:::
154160

155161
## I don't have SSH access

docs/es/bugs.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
# Reportando Bugs
22

33
::: danger Vulnerabilidades de seguridad
4+
45
Si descubre una vulnerabilidad de seguridad en Flarum, por favor envíe un correo electrónico a [security@flarum.org](mailto:security@flarum.org) para que podamos solucionarlo rápidamente.
6+
57
:::
68

79
Gracias por ayudarnos a testear Flarum. ¡Estamos contentos de tenerte en el equipo! Necesitamos gente que pueda *resolver problemas con paciencia* y *comunicarlos con claridad*. Como probablemente sepas, un buen informe de errores requiere algo de tiempo y esfuerzo. Si te parece bien, ¡empecemos!

docs/es/extend/README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,9 @@ Este enfoque hace que Flarum sea extremadamente personalizable. Un usuario puede
77
Para lograr esta extensibilidad, Flarum ha sido construido con ricas APIs y puntos de extensión. Con algunos conocimientos de programación, puedes aprovechar estas APIs para añadir casi cualquier característica que desees. Esta sección de la documentación pretende enseñarte cómo funciona Flarum, y cómo usar las APIs para que puedas construir tus propias extensiones.
88

99
::: warning
10+
1011
**Tanto la API de extensiones como esta documentación son un trabajo en curso.** ¡Ten en cuenta que las futuras versiones beta pueden romper tus extensiones! Si tienes comentarios, [nos encantaría escucharlos](https://discuss.flarum.org/).
12+
1113
:::
1214

1315
## Core vs. Extensiones

docs/es/extend/admin.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,9 @@ app.initializers.add('interstellar', function(app) {
3030
Una vez hecho esto, puedes empezar a añadir configuraciones y permisos.
3131

3232
::: Note
33+
3334
Todas las funciones de registro en `ExtensionData` son encadenables, lo que significa que puedes llamarlas una tras otra sin tener que volver a ejecutar `for`.
35+
3436
:::
3537

3638
### Registro de ajustes

docs/es/extend/api-throttling.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,10 @@ Flarum viene con un `Flarum\Api\Middleware\ThrottleApi` [middleware](middleware.
44
Esto se ejecuta en cada ruta de la API, y las extensiones pueden añadir su propia lógica personalizada para acelerar las solicitudes.
55

66
::: warning Rutas del Foro
7+
78
Algunas rutas del foro (inicio de sesión, registro, olvido de contraseña, etc) funcionan llamando a una ruta de la API bajo la superficie.
89
El middleware `ThrottleApi` no se ejecuta actualmente para estas peticiones, pero está previsto para el futuro.
10+
911
:::
1012

1113
## Aceleradores personalizados

docs/es/extend/backend-events.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,9 @@
33
A menudo, una extensión querrá reaccionar a algunos eventos que ocurren en otra parte de Flarum. Por ejemplo, podríamos querer incrementar un contador cuando se publica una nueva discusión, enviar un email de bienvenida cuando un usuario se conecta por primera vez, o añadir etiquetas a una discusión antes de guardarla en la base de datos. Estos eventos se conocen como **eventos de dominio**, y se transmiten a todo el framework a través del [sistema de eventos de Laravel](https://laravel.com/docs/6.x/events).
44

55
:::warning Antigua API de eventos
6+
67
Históricamente, Flarum ha utilizado eventos para su API de extensión, emitiendo eventos como `GetDisplayName` o `ConfigureApiRoutes` para permitir a las extensiones insertar lógica en varias partes de Flarum. Estos eventos se están eliminando gradualmente en favor del sistema declarativo [extender] (start.md#extenders), y se eliminarán antes de que sea estable. Los eventos de dominio no serán eliminados.
8+
79
:::
810

911
Para obtener una lista completa de los eventos del backend, consulte nuestra [documentación de la API](https://api.docs.flarum.org/php/master/search.html?search=Event). Las clases de eventos del dominio están organizadas por espacio de nombres, normalmente `Flarum\TYPE\Event`.

docs/es/extend/console.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,5 +40,7 @@ return [
4040
```
4141

4242
::: tip Comandos Programados
43+
4344
La [fof/console library](https://github.com/FriendsOfFlarum/console) le permite programar comandos para que se ejecuten en un intervalo regular. Sin embargo, tenga en cuenta que se trata de una solución comunitaria.
45+
4446
:::

docs/es/extend/frontend.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -176,7 +176,9 @@ return [
176176
Flarum hará que cualquier cosa que haga `export` desde `forum.js` esté disponible en el objeto global `flarum.extensions['acme-hello-world']`. Por lo tanto, puede elegir exponer su propia API pública para que otras extensiones interactúen con ella.
177177

178178
::: tip Bibliotecas externas
179+
179180
Sólo se permite un archivo JavaScript principal por extensión. Si necesitas incluir alguna librería JavaScript externa, instálala con NPM e `import` para que se compile en tu archivo JavaScript, o consulta [Rutas y Contenido](/extend/routes.md) para saber cómo añadir etiquetas `<script>` adicionales al documento del frontend.
181+
180182
:::
181183

182184
### CSS
@@ -190,7 +192,9 @@ También puedes añadir activos CSS y [LESS](http://lesscss.org/features/) al fr
190192
```
191193

192194
::: tip
195+
193196
Debes desarrollar las extensiones con el modo de depuración **activado** en `config.php`. Esto asegurará que Flarum recompile los activos de forma automática, por lo que no tendrás que limpiar manualmente la caché cada vez que hagas un cambio en el JavaScript de tu extensión.
197+
194198
:::
195199

196200
## Cambiando la UI Parte 1

docs/es/extend/i18n.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,9 @@ Dado que las traducciones al inglés podrían ser lo único que se interponga en
2626
Los recursos lingüísticos de Flarum utilizan el formato de archivo [YAML](https://en.wikipedia.org/wiki/YAML). Los archivos de localización de una extensión de terceros deben almacenarse en la carpeta `locale` de la extensión. Cada archivo de configuración regional debe nombrarse utilizando el [código ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) del idioma que contiene. Por ejemplo, un archivo que contenga traducciones al francés debe llamarse "`fr.yml`".
2727

2828
::: tip
29+
2930
Si desea proporcionar soporte para una localización específica, puede añadir un guión bajo seguido de un código de país [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes); el nombre de archivo para el francés hablado en Canadá, por ejemplo, sería "`fr_CA.yml`". Pero debe asegurarse de incluir un archivo de configuración regional que contenga traducciones "genéricas" para el mismo idioma, de modo que Flarum tenga algo a lo que recurrir en caso de que un usuario especifique una configuración regional que usted no haya previsto.
31+
3032
:::
3133

3234
El esqueleto de la extensión incluye una plantilla `locale/en.yml` donde puedes poner las traducciones al inglés de tu extensión. Si quieres añadir recursos para otro idioma o localización, simplemente duplica la plantilla y dale un nombre de archivo apropiado. A continuación, abre el archivo y empieza a añadir tus traducciones.
@@ -64,6 +66,7 @@ Eso es todo lo que necesitas saber sobre la mecánica de la creación de claves.
6466
Los ejemplos de la sección anterior ya le han dado lo básico: usted escribe una clave de identificación &mdash; seguida de dos puntos y un espacio &mdash; luego escribe la traducción. Así de fácil. Aquí sólo queremos añadir algunos detalles que le ayudarán a tratar con traducciones más largas y complejas.
6567

6668
::: warning Comillas
69+
6770
Habrás notado que sólo una de las dos traducciones de ejemplo de la sección anterior iba entre comillas. Por lo general, no es necesario delimitar las traducciones de este modo. Sin embargo, debe utilizar **comillas dobles** para encerrar cualquier traducción que incluya uno o más de los siguientes caracteres:
6871

6972
```
@@ -73,6 +76,7 @@ Habrás notado que sólo una de las dos traducciones de ejemplo de la sección a
7376
Dado que Flarum utiliza corchetes y paréntesis angulares para denotar marcadores de posición para [variables] (#including-variables) y [etiquetas HTML](#html-tags), respectivamente, no hace falta decir que cualquier traducción que incluya dichos marcadores de posición también deberá ir entre comillas dobles.
7477

7578
Además, debe utilizar **comillas simples** para encerrar cualquier traducción que incluya uno o más caracteres de comillas dobles (`"`) o barras invertidas (`\`). Esta regla tiene prioridad. Así que si una traducción incluyera tanto comillas dobles como uno o más caracteres de la lista anterior &mdash; como lo hace [este ejemplo](#incluyendo-variables), en el que un marcador de posición de una variable está delimitado por comillas &mdash; tendría que encerrarlo entre *comillas simples*.
79+
7680
:::
7781

7882
#### Bloques literales

0 commit comments

Comments
 (0)