---
title: ตั้งค่าที่เก็บข้อมูล
slug: th/user-guides/5OX8rCTRT-S9iop536wl4
description: เรียนรู้วิธีตั้งค่าที่เก็บข้อมูลสำหรับ Archbee แพลตฟอร์มการทำเอกสารร่วมกัน ผ่านคู่มือทีละขั้นตอนนี้ สร้างไฟล์ `.archbee.yaml` ที่มีโครงสร้างตัวแปรและสำรวจตัวอย่างไฟล์คอนฟิก `.yaml` และ `.json` ค้นพบความสำคัญ
createdAt: 2023-01-18T13:04:58.000Z
---

## ตั้งค่าที่เก็บ (repository)

สมมติว่าคุณได้[ทำการเชื่อมต่อเสร็จเรียบร้อยแล้ว](https://docs.archbee.com/github#jJpEV) ขั้นตอนถัดไปคือการตั้งค่าที่เก็บ (repository)

คุณต้องตั้งค่าและกำหนดค่า repo ของคุณให้สำเร็จ เพื่อให้ Archbee สามารถดึงเนื้อหาที่อยู่ในนั้นและจัดการให้เรียบร้อยในระบบของเรา

:::hint{type="info"}
คุณสามารถ[fork repository นี้](https://github.com/dragosbulugean/slate)ได้
:::

หากระบบพบไฟล์`.archbee.yaml` ใน root ของ repository ของคุณหรือโฟลเดอร์อื่นๆ (หากคุณใช้ multipath) เช่นนี้[ไฟล์ .yaml](https://github.com/dragosbulugean/slate/blob/master/.archbee.yaml) ระบบจะใช้ไฟล์นั้นเพื่อจัดระเบียบเนื้อหา

:::hint{type="warning"}
โปรดให้ความสนใจเป็นพิเศษกับไฟล์ .[yaml](https://github.com/dragosbulugean/slate/blob/master/.archbee.yaml) ที่นี่ หากคุณต้องการกำหนดค่าโฟลเดอร์ที่เนื้อหา markdown ถูก render มาจาก (หรือโครงสร้างเอกสารแบบ summary tree)
:::

### สร้างไฟล์ .yaml

สร้างไฟล์`.archbee.yaml` พร้อมโครงสร้างตัวแปรดังต่อไปนี้:

:::hint{type="danger"}
คุณต้องวางไฟล์ไว้ในโฟลเดอร์รูทของที่เก็บ (repository) ของคุณ ตรวจสอบให้แน่ใจว่าไฟล์ยังคงอยู่ที่นั่น เนื่องจากเป็นเส้นทางเริ่มต้นสำหรับโฟลเดอร์อื่น ๆ – หากคุณมีหลายโฟลเดอร์ คุณต้องคัดลอกไฟล์ไปยังโฟลเดอร์เหล่านั้นด้วย

ถามว่าทำอย่างไร? ดูวิธี [ซิงค์หลายโฟลเดอร์](https://docs.archbee.com/sync-multiple-github-folders) ได้เลย
:::

### คีย์เหล่านี้หมายความว่าอย่างไร?

- `root: ./docs` : คุณสมบัตินี้กำหนดตำแหน่งไดเรกทอรีที่มีเอกสาร (สามารถแทนที่ด้วย `docsPath: ./docs`)
- `structure:`
  - `summary: summary.md` : สร้างโครงสร้างเอกสารใหม่ในแถบนำทางด้านซ้ายใน Archbee หากไม่มี เราจะถือว่าโฟลเดอร์เป็นหมวดหมู่และจำลองโครงสร้างไฟล์ภายใน
  - `assets: assets` : โฟลเดอร์ assets จะสัมพันธ์กับ `docsPath`. Archbee จะอัปโหลดไฟล์ทั้งหมดที่พบในโฟลเดอร์นั้น (ไฟล์โค้ดและรูปภาพ)
- `shadowDocs` : คุณต้องกำหนดไฟล์/โฟลเดอร์โค้ดที่จะรวมเป็น *Shadow docs*
- `publishSpace` : ค่า boolean ตั้งเป็น `true` หากคุณต้องการเผยแพร่พื้นที่ไปยัง production portal หลังจากแต่ละ commit

ตัวอย่างของไฟล์ `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> 
```
:::

ตัวอย่างของ `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": ""
}
```
:::

### สร้างไฟล์ summary.md

เรายังแนะนำให้คุณสร้างไฟล์ `summary.md` ไฟล์นี้จะช่วยให้ `summary.md` สร้างโครงสร้างเอกสารในแผงนำทางด้านซ้ายของ Archbee และช่วยให้คุณจัดระเบียบเนื้อหาได้อย่างเป็นระเบียบ

ดูตัวอย่างไฟล์ `summary.md` ด้านล่าง:

:::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)

```
:::

## ใช้ไวยากรณ์ Markdown กับ GitHub

บล็อกเนื้อหาบางประเภทสามารถเรนเดอร์ได้หากคุณใช้ไวยากรณ์เฉพาะ

ตรวจสอบ [ทางลัด Markdown ของโปรแกรมแก้ไข](docId:1mgrOzhjKNd15rSrjHvfx) เพื่อใช้คีย์ลัดเหล่านี้

## เพิ่มที่เก็บหลายรายการ

ทำตามขั้นตอนง่ายๆ เหล่านี้เพื่อเพิ่มที่เก็บ (repositories) หลายรายการและซิงก์กับ Archbee:

::::WorkflowBlock
:::WorkflowBlockItem
ไปที่บัญชี [GitHub](https://github.com/settings/installations) ที่เชื่อมต่อกับ Archbee จากนั้นไปที่หน้า **Settings** .

บนแถบด้านซ้าย ให้มองหาเมนู **Applications.**

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/HChEov2q-7IXyJVa81Mbj_github-appconfigure-light.png "หน้าการตั้งค่าแอป GitHub")
:::

:::WorkflowBlockItem
คลิกปุ่ม **Configure&#x20;**&#xE41;ละเมื่อหน้าใหม่เปิดขึ้น ให้กำหนดสิทธิ์เข้าถึงดังนี้:

1. *ที่เก็บทั้งหมด* (ซึ่งหมายความว่าคุณสามารถเลือก repo ใดก็ได้จากบัญชี Archbee ของคุณ)
2. *เลือกเฉพาะที่เก็บบางรายการ* (เลือกที่เก็บใหม่ที่คุณต้องการซิงก์กับ Archbee)
3. คลิก Save



![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/zspijTRLT875JPad9Cecf_image.png "เลือกที่เก็บ")
:::

:::WorkflowBlockItem
กลับไปที่บัญชี Archbee ของคุณ

จากแผงนำทางด้านซ้าย ให้สร้าง **Space** ใหม่ -> เลือก **Write in GitHub** และเลือกที่เก็บที่คุณเพิ่งเพิ่มเข้ามา
:::
::::

## นำเข้าไฟล์ Open API

คุณสามารถนำเข้าไฟล์ Open API ผ่าน GitHub ได้ ฟีเจอร์นี้ทำงานเหมือนกับฟีเจอร์ [การนำเข้า OpenAPI / Swagger](docId\:RCAmfVNEqblHZiQBlYTkD) รวมถึงการตั้งค่าต่างๆ มีสิ่งสำคัญ 2 อย่างที่ต้องตั้งค่า:

- เส้นทางไปยังไฟล์ Open API (.json, .yml, .yaml) ที่ต้องเขียนไว้ใน `summary.md` ไฟล์คอนฟิก
- การตั้งค่าที่ต้องเขียนในไฟล์คอนฟิกหลักภายใต้ `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: ""

```
:::