---
title: Configurar el repositorio
slug: docs/es/configurar-el-repositorio
description: Aprende cómo configurar un repositorio para Archbee, una plataforma de colaboración de documentación, con esta guía paso a paso. Crea un archivo `.archbee.yaml` con estructuras de variables y explora ejemplos de archivos de configuración `.yaml` y `.json`
docTags: 
createdAt: 2023-01-18T13:04:58.000Z
---

## Configurar el repositorio

Suponiendo que ya ha [completado la integración](https://docs.archbee.com/github#jJpEV), el siguiente paso es configurar un repositorio.

Debe configurar y ajustar correctamente su repositorio para que Archbee pueda obtener el contenido y organizarlo adecuadamente en nuestro sistema.

:::hint{type="info"}
Puede [hacer fork de este repositorio](https://github.com/dragosbulugean/slate).
:::

Si el sistema encuentra un archivo `.archbee.yaml` en la raíz de su repositorio u otras carpetas (en caso de que use multipath), como este [.archivo yaml](https://github.com/dragosbulugean/slate/blob/master/.archbee.yaml), entonces lo usamos para organizar el contenido.

:::hint{type="warning"}
Preste mucha atención al archivo .[archivo yaml](https://github.com/dragosbulugean/slate/blob/master/.archbee.yaml) aquí si desea configurar la carpeta desde donde se renderiza el contenido markdown (o una jerarquía del árbol de documentos).
:::

### Crear archivo .yaml

Cree un archivo `.archbee.yaml` con la siguiente estructura de variables:

:::hint{type="danger"}
Debe colocar el archivo en la carpeta raíz de su(s) repositorio(s). Asegúrese de que el archivo permanezca allí, ya que este es su camino predeterminado para otras carpetas. Si tiene varias carpetas, debe copiar el archivo en cada una de ellas.

¿Cómo, pregunta? Revise cómo [sincronizar múltiples carpetas](https://docs.archbee.com/sync-multiple-github-folders).
:::

### ¿Qué significan todas estas claves?

- `root: ./docs` : esta propiedad define dónde está el directorio que contiene la documentación (puede reemplazarse con `docsPath: ./docs`)
- `estructura:`
  - `summary: summary.md` : reconstruye el árbol de documentos en el panel de navegación izquierdo en Archbee. Si no existe, consideramos las carpetas como categorías y replicamos la estructura de archivos interna.
  - `activos: activos` : la carpeta de assets es relativa a `docsPath`. Archbee cargará todos los archivos encontrados en esa carpeta (archivos de código e imágenes).
- `shadowDocs` : debe definir los archivos/carpetas de código que desea incluir como *Documentos sombra*
- `publishSpace` : booleano, establézcalo en `verdadero` si desea publicar el espacio en el portal de producción después de cada commit

Ejemplo de un archivo de configuración `archbee.yaml`:

:::CodeblockTabs
archbee.yaml

```yaml
root: doc-api
structure:
  summary: summary.md
  assets: assets
publishSpace: true
headerIncludes:  |
  <script>
  document.getElementById("demo").innerHTML = "Hello JavaScript!";
  </script> 
```
:::

Ejemplo de un archivo de configuración `archbee.json`:

:::CodeblockTabs
archbee.json

```json
{
  "root": "docfolderwithsummary",
  "structure": {
    "summary": "summary.md",
    "assets": ".archbee/assets"
  },
  "customJS":"",
  "customCSS":"* \n {  font-family: \"Comic Sans MS\", cursive, sans-serif; }",
  "footerTemplate": "",
  "headerIncludes": ""
}
```
:::

### Crear archivo summary.md

También recomendamos crear un archivo `summary.md`. El archivo `summary.md` reconstruye el árbol de documentos en el panel de navegación izquierdo en Archbee. Y puede ayudarle a organizar su contenido adecuadamente.

Vea un ejemplo de un archivo `summary.md` a continuación:

:::CodeblockTabs
summary.md

```markdown
- [Introduction](1.md)

## Table of contents

- [Init](init.md)
- [Configure App](config.md)
- [Config Database](config-database.md)
- [Config Redis](config-redis.md)
- [Config Elastic Search](config-es.md)
- [Swagger](swagger-v2.json)

```
:::

## Use sintaxis Markdown con GitHub

Algunos bloques de contenido pueden ser renderizados si usted usa una sintaxis específica.

Consulte los [Atajos de Editor Markdown](docId\:TTIZhu7Zl1J1Ii-Nsr2gq) para usar estos atajos.

## Agregar múltiples repositorios

Siga estos simples pasos para agregar múltiples repositorios y sincronizarlos con Archbee:

::::WorkflowBlock
:::WorkflowBlockItem
Vaya a su cuenta de [GitHub](https://github.com/settings/installations) conectada con Archbee y luego navegue a la página de **Configuraciones**.

En la barra lateral izquierda, busque **Aplicaciones.**

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/HChEov2q-7IXyJVa81Mbj_github-appconfigure-light.png "Página de aplicaciones de GitHub")
:::

:::WorkflowBlockItem
Haga clic en el botón **Configurar&#x20;**&#x79; cuando se abra la nueva página, proporcione acceso a:

1. *Todos los repositorios* (esto significa que usted puede seleccionar cualquier repo desde su cuenta Archbee)
2. *Solo repositorios seleccionados* (seleccione cualquier nuevo repositorio que desee sincronizar con Archbee)
3. Haga clic en Guardar



![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/zspijTRLT875JPad9Cecf_image.png "Seleccionar repositorios")
:::

:::WorkflowBlockItem
Regrese a su cuenta Archbee.

Desde el panel de navegación izquierdo, cree un nuevo **Espacio** -> elija **Escritura en GitHub** y seleccione los repositorios recién agregados.
:::
::::

## Importar archivos Open Api

Usted puede importar archivos Open Api mediante GitHub. Esta funcionalidad funciona exactamente como la función [Importación de OpenAPI / Swagger](docId\:PP4nemqG6pt4RK6klS7rq), incluyendo sus configuraciones. Hay 2 cosas importantes que configurar:

- rutas a los archivos Open Api (.json, .yml, .yaml) que deben escribirse en el archivo de configuración `summary.md`
- configuraciones que deben escribirse en el archivo de configuración principal bajo `docTreeOptions`:

:::CodeblockTabs
.archbee.yaml

```yaml
docsPath: ./myapp-docs
structure:
  summary: toc.md
  assets: assets
  docTreeOptions:
    openApiTryIt: false
    showDownloadOpenApiFile: true
    shouldCreateSchemaCategory: true
    shouldCreateIntro: true
    openApiLanguageExamples:
      - value: python
        label: py
      - value: javascript
        label: js
footerTemplate: ""
headerIncludes: ""

```
:::