siyuan

ปรับโครงสร้างความคิดของคุณใหม่

中文 | 日本語

---

สารบัญ

• การแนะนำ
• - คุณสมบัติ
• สถาปัตยกรรมและระบบนิเวศ
• - ประวัติดารา
• ️โรดแมป
• ดาวน์โหลดการตั้งค่า
  • ตลาดแอพ
  • แพ็คเกจการติดตั้ง
  • นักเทียบท่าโฮสติ้ง
  • Unraid โฮสติ้ง
  • ตัวอย่างวงใน
• ️ชุมชน
• คู่มือการพัฒนา
• ❓ คำถามที่พบบ่อย
  • siyuan เก็บข้อมูลอย่างไร?
  • รองรับการซิงโครไนซ์ข้อมูลผ่านดิสก์ซิงค์ของบริษัทอื่นหรือไม่
  • siyuan เป็นโอเพ่นซอร์สหรือไม่?
  • จะอัพเกรดเป็นเวอร์ชั่นใหม่ได้อย่างไร?
  • จะเกิดอะไรขึ้นหากบางบล็อก (เช่น บล็อกย่อหน้าในรายการ) ไม่พบไอคอนบล็อก
  • ฉันควรทำอย่างไรหากคีย์ repo ข้อมูลสูญหาย
  • ฉันจำเป็นต้องจ่ายเงินเพื่อมันหรือไม่?
• รับทราบ
  • ผู้ร่วมให้ข้อมูล

---

การแนะนำ

siyuan เป็นระบบการจัดการความรู้ส่วนบุคคลที่เน้นความเป็นส่วนตัว รองรับการอ้างอิงระดับบล็อกแบบละเอียดและ Markdown WYSIWYG

ยินดีต้อนรับสู่ฟอรัมสนทนาภาษาอังกฤษ siyuan เพื่อเรียนรู้เพิ่มเติม

- คุณสมบัติ

คุณสมบัติส่วนใหญ่ใช้งานได้ฟรี แม้จะใช้งานในเชิงพาณิชย์ก็ตาม

• บล็อกเนื้อหา
  • การอ้างอิงระดับบล็อกและลิงก์สองทาง
  • แอตทริบิวต์ที่กำหนดเอง
  • ฝังแบบสอบถาม SQL
  • โปรโตคอล siyuan ://
• บรรณาธิการ
  • แบบบล็อก
  • มาร์กดาวน์แบบ WYSIWYG
  • โครงร่างรายการ
  • บล็อกการซูมเข้า
  • การแก้ไขเอกสารขนาดใหญ่ล้านคำ
  • สูตรทางคณิตศาสตร์ แผนภูมิ ผังงาน แผนภูมิแกนต์ แผนภูมิกำหนดเวลา พนักงาน ฯลฯ
  • การตัดเว็บ
  • ลิงก์คำอธิบายประกอบ PDF
• ส่งออก
  • บล็อกการอ้างอิงและฝัง
  • Markdown มาตรฐานพร้อมสินทรัพย์
  • PDF, Word และ HTML
  • คัดลอกไปยัง WeChat MP, Zhihu และ Yuque
• ฐานข้อมูล
  • มุมมองตาราง
• Flashcard เว้นระยะการซ้ำกัน
• การเขียน AI และการแชทถาม/ตอบผ่าน OpenAI API
• เทสเซอร์แรค โอซีอาร์
• หลายแท็บ ลากและวางเพื่อแยกหน้าจอ
• ตัวอย่างเทมเพลต
• ข้อมูลโค้ด JavaScript/CSS
• แอพ Android/iOS
• การปรับใช้นักเทียบท่า
• เอพีไอ
• ตลาดชุมชน

คุณสมบัติบางอย่างมีให้เฉพาะสมาชิกแบบชำระเงินเท่านั้น สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ราคา

สถาปัตยกรรมและระบบนิเวศ

โครงการ	คำอธิบาย	ส้อม	ดาว
พิณ	เครื่องมือแก้ไข
โครเมี่ยม	ส่วนขยาย Chrome/Edge
ตลาดสด	ตลาดชุมชน
เดจาวู	คลังข้อมูล
กลีบดอกไม้	ปลั๊กอิน API
หุ่นยนต์	แอพ Android
ไอโอเอส	แอพ iOS
ริฟฟ์	การเว้นระยะการทำซ้ำ

- ประวัติดารา

siyuan &type=Date">

️โรดแมป

• แผนพัฒนา siyuan และความคืบหน้า
• บันทึกการเปลี่ยนแปลง siyuan

ดาวน์โหลดการตั้งค่า

ขอแนะนำให้ให้ความสำคัญกับการติดตั้งผ่านตลาดแอปพลิเคชันบนเดสก์ท็อปและอุปกรณ์เคลื่อนที่ เพื่อให้คุณสามารถอัปเกรดเวอร์ชันได้ด้วยคลิกเดียวในอนาคต

ตลาดแอพ

มือถือ:

• แอพสโตร์
• Google Play
• F-ดรอยด์

เดสก์ท็อป:

• ไมโครซอฟต์ สโตร์

แพ็คเกจการติดตั้ง

• B3log
• GitHub

นักเทียบท่าโฮสติ้ง

การปรับใช้นักเทียบท่า

ภาพรวม

วิธีที่ง่ายที่สุดในการเสิร์ฟ siyuan บนเซิร์ฟเวอร์คือการปรับใช้ผ่าน Docker

• ชื่อภาพ b3log/ siyuan
• URL รูปภาพ

โครงสร้างไฟล์

โปรแกรมโดยรวมอยู่ภายใต้ /opt/ siyuan / ซึ่งโดยพื้นฐานแล้วเป็นโครงสร้างภายใต้โฟลเดอร์ทรัพยากรของแพ็คเกจการติดตั้ง Electron:

• ลักษณะที่ปรากฏ: ไอคอน ธีม ภาษา
• guide: เอกสารคู่มือผู้ใช้
• เวที: อินเทอร์เฟซและทรัพยากรแบบคงที่
• เคอร์เนล: โปรแกรมเคอร์เนล

จุดเริ่มต้น

จุดเริ่มต้นถูกตั้งค่าเมื่อสร้างอิมเมจ Docker: ENTRYPOINT ["/opt/ siyuan /entrypoint.sh"] สคริปต์นี้อนุญาตให้เปลี่ยน PUID และ PGID ของผู้ใช้ที่จะทำงานภายในคอนเทนเนอร์ สิ่งนี้มีความเกี่ยวข้องอย่างยิ่งในการแก้ไขปัญหาการอนุญาตเมื่อติดตั้งไดเร็กทอรีจากโฮสต์ PUID (User ID) และ PGID (Group ID) สามารถส่งผ่านเป็นตัวแปรสภาพแวดล้อมได้ ทำให้ง่ายต่อการรับรองการอนุญาตที่ถูกต้องเมื่อเข้าถึงไดเร็กทอรีที่เมาท์กับโฮสต์

ใช้พารามิเตอร์ต่อไปนี้เมื่อรันคอนเทนเนอร์ด้วย docker run b3log/ siyuan :

• --workspace : ระบุเส้นทางโฟลเดอร์พื้นที่ทำงาน ซึ่งต่อเข้ากับคอนเทนเนอร์ผ่าน -v บนโฮสต์
• --accessAuthCode : ระบุรหัสอนุญาตการเข้าถึง

สามารถดูพารามิเตอร์เพิ่มเติมได้โดยใช้ --help นี่คือตัวอย่างของคำสั่งเริ่มต้นระบบที่มีตัวแปรสภาพแวดล้อมใหม่:

docker run -d 
  -v workspace_dir_host:workspace_dir_container 
  -p 6806:6806 
  -e PUID=1001 -e PGID=1002 
  b3log/ siyuan 
  --workspace=workspace_dir_container 
  --accessAuthCode=xxx

• PUID : ID ผู้ใช้ที่กำหนดเอง (ไม่บังคับ ค่าเริ่มต้นคือ 1000 หากไม่ได้ระบุ)
• PGID : ID กลุ่มที่กำหนดเอง (ไม่บังคับ ค่าเริ่มต้นคือ 1000 หากไม่ได้ระบุ)
• workspace_dir_host : พาธโฟลเดอร์เวิร์กสเปซบนโฮสต์
• workspace_dir_container : พาธของโฟลเดอร์เวิร์กสเปซในคอนเทนเนอร์ ตามที่ระบุไว้ใน --workspace
• accessAuthCode : รหัสอนุญาตการเข้าถึง (โปรด แน่ใจว่าได้แก้ไข ไม่เช่นนั้นใครก็ตามจะสามารถเข้าถึงข้อมูลของคุณได้)

เพื่อให้สิ่งต่าง ๆ ง่ายขึ้น ขอแนะนำให้กำหนดค่าพาธโฟลเดอร์พื้นที่ทำงานให้สอดคล้องกันบนโฮสต์และคอนเทนเนอร์ เช่น กำหนดให้ทั้ง workspace_dir_host และ workspace_dir_container กำหนดค่าเป็น / siyuan /workspace คำสั่งเริ่มต้นที่เกี่ยวข้องจะเป็น:

docker run -d 
  -v / siyuan /workspace:/ siyuan /workspace 
  -p 6806:6806 
  -e PUID=1001 -e PGID=1002 
  b3log/ siyuan 
  --workspace=/ siyuan /workspace/ 
  --accessAuthCode=xxx

นักเทียบท่าเขียน

สำหรับผู้ใช้ที่ใช้งาน siyuan ด้วย Docker Compose คุณสามารถส่งผ่านตัวแปรสภาพแวดล้อม PUID และ PGID เพื่อปรับแต่ง ID ผู้ใช้และกลุ่มได้ นี่คือตัวอย่างการกำหนดค่า Docker Compose:

 version : " 3.9 "
services :
  main :
    image : b3log/ siyuan
    command : ['--workspace=/ siyuan /workspace/', '--accessAuthCode=${AuthCode}']
    ports :
      - 6806:6806
    volumes :
      - / siyuan /workspace:/ siyuan /workspace
    restart : unless-stopped
    environment :
      # A list of time zone identifiers can be found at https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
      - TZ=${YOUR_TIME_ZONE}
      - PUID=${YOUR_USER_PUID}  # Customize user ID
      - PGID=${YOUR_USER_PGID}  # Customize group ID

ในการตั้งค่านี้:

• PUID และ PGID ได้รับการตั้งค่าแบบไดนามิกและส่งผ่านไปยังคอนเทนเนอร์
• หากไม่มีการระบุตัวแปรเหล่านี้ ระบบจะใช้ค่าเริ่มต้น 1000

ด้วยการระบุ PUID และ PGID ในสภาพแวดล้อม คุณจะหลีกเลี่ยงความจำเป็นในการตั้งค่าคำสั่ง user อย่างชัดเจน ( user: '1000:1000' ) ในไฟล์เขียน คอนเทนเนอร์จะปรับผู้ใช้และกลุ่มแบบไดนามิกตามตัวแปรสภาพแวดล้อมเหล่านี้เมื่อเริ่มต้น

สิทธิ์ของผู้ใช้

ในรูปภาพ สคริปต์ entrypoint.sh รับประกันการสร้างผู้ใช้และกลุ่ม siyuan ด้วย PUID และ PGID ที่ระบุ ดังนั้น เมื่อโฮสต์สร้างโฟลเดอร์พื้นที่ทำงาน ให้ใส่ใจกับการตั้งค่าความเป็นเจ้าของโฟลเดอร์ของผู้ใช้และกลุ่มให้ตรงกับ PUID และ PGID ที่คุณวางแผนจะใช้ ตัวอย่างเช่น:

chown -R 1001:1002 / siyuan /workspace

หากคุณใช้ค่า PUID และ PGID แบบกำหนดเอง สคริปต์จุดเข้าใช้งานจะทำให้แน่ใจว่ามีการสร้างผู้ใช้และกลุ่มที่ถูกต้องภายในคอนเทนเนอร์ และความเป็นเจ้าของไดรฟ์ข้อมูลที่ติดตั้งจะถูกปรับตามนั้น ไม่จำเป็นต้องส่ง -u ด้วยตนเองใน docker run หรือ docker-compose เนื่องจากตัวแปรสภาพแวดล้อมจะจัดการการปรับแต่งเอง

พอร์ตที่ซ่อนอยู่

ใช้พร็อกซีย้อนกลับ NGINX เพื่อซ่อนพอร์ต 6806 โปรดทราบ:

• กำหนดค่าพร็อกซีย้อนกลับของ WebSocket /ws

บันทึก

• ต้องแน่ใจว่าได้ยืนยันความถูกต้องของโวลุ่มที่ติดตั้ง ไม่เช่นนั้นข้อมูลจะสูญหายหลังจากลบคอนเทนเนอร์แล้ว
• อย่าใช้การเขียน URL ใหม่เพื่อเปลี่ยนเส้นทาง มิฉะนั้นอาจเกิดปัญหากับการตรวจสอบสิทธิ์ ขอแนะนำให้กำหนดค่าพร็อกซีย้อนกลับ
• หากคุณพบปัญหาการอนุญาต ให้ตรวจสอบว่าตัวแปรสภาพแวดล้อม PUID และ PGID ตรงกับความเป็นเจ้าของไดเร็กทอรีที่เมาท์บนระบบโฮสต์ของคุณ

ข้อจำกัด

• ไม่รองรับการเชื่อมต่อเดสก์ท็อปและแอปพลิเคชันมือถือ รองรับการใช้งานบนเบราว์เซอร์เท่านั้น
• ไม่รองรับการส่งออกเป็นรูปแบบ PDF, HTML และ Word
• ไม่รองรับการนำเข้าไฟล์ Markdown

Unraid โฮสติ้ง

การปรับใช้ Unraid

หมายเหตุ: รันครั้งแรก chown -R 1000:1000 /mnt/user/appdata/ siyuan ในเทอร์มินัล

การอ้างอิงเทมเพลต:

 Web UI: 6806
Container Port: 6806
Container Path: /home/ siyuan
Host path: /mnt/user/appdata/ siyuan
PUID: 1000
PGID: 1000
Publish parameters: --accessAuthCode=******(Access authorization code)

ตัวอย่างวงใน

เราเผยแพร่ตัวอย่างวงในก่อนการอัปเดตที่สำคัญ โปรดไปที่ https://github.com/siyuan-note/insider

️ชุมชน

• กระดานสนทนาภาษาอังกฤษ
• สรุปชุมชนผู้ใช้
• เจ๋งเลย siyuan

คู่มือการพัฒนา

ดูคู่มือการพัฒนา

❓ คำถามที่พบบ่อย

siyuan เก็บข้อมูลอย่างไร?

ข้อมูลจะถูกบันทึกในโฟลเดอร์พื้นที่ทำงาน ในโฟลเดอร์ข้อมูลพื้นที่ทำงาน:

• assets ใช้เพื่อบันทึกเนื้อหาที่แทรกทั้งหมด
• emojis ใช้เพื่อบันทึกภาพอิโมจิ
• snippets ใช้เพื่อบันทึกข้อมูลโค้ด
• storage ใช้เพื่อบันทึกเงื่อนไขการสืบค้น เค้าโครง และแฟลชการ์ด ฯลฯ
• templates ใช้เพื่อบันทึกตัวอย่างเทมเพลต
• widgets ใช้เพื่อบันทึกวิดเจ็ต
• plugins ใช้เพื่อบันทึกปลั๊กอิน
• public ใช้เพื่อบันทึกข้อมูลสาธารณะ
• โฟลเดอร์ที่เหลือคือโฟลเดอร์สมุดบันทึกที่สร้างโดยผู้ใช้ ไฟล์ที่มีส่วนต่อท้ายเป็น .sy ในโฟลเดอร์สมุดบันทึกจะถูกใช้เพื่อบันทึกข้อมูลเอกสาร และรูปแบบข้อมูลคือ JSON

รองรับการซิงโครไนซ์ข้อมูลผ่านดิสก์ซิงค์ของบริษัทอื่นหรือไม่

ไม่รองรับการซิงโครไนซ์ข้อมูลผ่านดิสก์การซิงโครไนซ์ของบริษัทอื่น มิฉะนั้นข้อมูลอาจเสียหาย

แม้ว่าจะไม่รองรับดิสก์การซิงค์ของบริษัทอื่น แต่ก็รองรับการเชื่อมต่อกับที่เก็บข้อมูลบนคลาวด์ของบริษัทอื่น (สิทธิ์ของสมาชิก)

นอกจากนี้ คุณยังสามารถพิจารณาส่งออกและนำเข้าข้อมูลด้วยตนเองเพื่อให้เกิดการซิงโครไนซ์ข้อมูล:

• เดสก์ท็อป: การตั้งค่า - ส่งออก - ส่งออกข้อมูล / นำเข้าข้อมูล
• อุปกรณ์เคลื่อนที่: คอลัมน์ด้านขวา - เกี่ยวกับ - ส่งออกข้อมูล / นำเข้าข้อมูล

siyuan เป็นโอเพ่นซอร์สหรือไม่?

siyuan เป็นโอเพ่นซอร์สโดยสมบูรณ์ และยินดีต้อนรับการมีส่วนร่วม:

• ส่วนต่อประสานผู้ใช้และเคอร์เนล
• หุ่นยนต์
• ไอโอเอส
• ส่วนขยายการคลิป Chrome

สำหรับรายละเอียดเพิ่มเติม โปรดดูคู่มือการพัฒนา

จะอัพเกรดเป็นเวอร์ชั่นใหม่ได้อย่างไร?

• หากติดตั้งผ่าน App Store โปรดอัปเดตผ่าน App Store
• หากติดตั้งผ่านแพ็คเกจการติดตั้งบนเดสก์ท็อป คุณสามารถเปิดตัวเลือก การตั้งค่า - เกี่ยวกับ - ดาวน์โหลดแพ็คเกจการติดตั้งอัพเดตโดยอัตโนมัติ เพื่อให้ siyuan ดาวน์โหลดแพ็คเกจการติดตั้งเวอร์ชันล่าสุดโดยอัตโนมัติและแจ้งให้ติดตั้ง
• หากมีการติดตั้งโดยแพ็คเกจการติดตั้งด้วยตนเอง โปรดดาวน์โหลดแพ็คเกจการติดตั้งอีกครั้งเพื่อติดตั้ง

คุณสามารถ ตรวจสอบการอัปเดตได้ ใน การตั้งค่า - เกี่ยวกับ - เวอร์ชันปัจจุบัน หรือให้ความสนใจกับการดาวน์โหลดอย่างเป็นทางการหรือการเปิดตัว GitHub เพื่อรับเวอร์ชันใหม่

จะเกิดอะไรขึ้นหากบางบล็อก (เช่น บล็อกย่อหน้าในรายการ) ไม่พบไอคอนบล็อก

บล็อกย่อยแรกภายใต้รายการคือละเว้นไอคอนบล็อก คุณสามารถเลื่อนเคอร์เซอร์ไปที่บล็อกนี้และเรียกเมนูบล็อกด้วย Ctrl+/

ฉันควรทำอย่างไรหากคีย์ repo ข้อมูลสูญหาย

• หากคีย์คลังข้อมูลได้รับการเตรียมใช้งานอย่างถูกต้องบนอุปกรณ์หลายเครื่องก่อนหน้านี้ คีย์จะเหมือนกันบนอุปกรณ์ทั้งหมดและสามารถตั้งค่าได้ใน การตั้งค่า - เกี่ยวกับ - คีย์คลังข้อมูล - ดึงสตริงคีย์คัด ลอก

• หากไม่ได้รับการกำหนดค่าอย่างถูกต้องมาก่อน (เช่น คีย์บนอุปกรณ์หลายเครื่องไม่สอดคล้องกัน) หรืออุปกรณ์ทั้งหมดไม่พร้อมใช้งานและไม่สามารถรับสตริงคีย์ได้ คุณสามารถรีเซ็ตคีย์ได้โดยทำตามขั้นตอนด้านล่าง:

  1. สำรองข้อมูลด้วยตนเอง คุณสามารถใช้ ส่งออกข้อมูล หรือคัดลอก พื้นที่ทำงาน/ข้อมูล/ โฟลเดอร์บนระบบไฟล์ได้โดยตรง
  2. การตั้งค่า - เกี่ยวกับ - รหัสตัวแทนข้อมูล - รีเซ็ตคลังข้อมูล
  3. เตรียมใช้งานคีย์ repo ข้อมูลอีกครั้ง หลังจากเริ่มต้นคีย์บนอุปกรณ์เครื่องหนึ่งแล้ว อุปกรณ์อื่นๆ จะนำเข้าคีย์นั้น
  4. คลาวด์ใช้ไดเร็กทอรีการซิงโครไนซ์ใหม่ ไดเร็กทอรีการซิงโครไนซ์เก่าไม่สามารถใช้งานได้อีกต่อไปและสามารถลบได้
  5. Cloud Snapshots ที่มีอยู่ไม่สามารถใช้งานได้อีกต่อไปและสามารถลบได้

ฉันจำเป็นต้องจ่ายเงินเพื่อมันหรือไม่?

คุณสมบัติส่วนใหญ่ใช้งานได้ฟรี แม้จะใช้งานในเชิงพาณิชย์ก็ตาม

สิทธิพิเศษของสมาชิกสามารถใช้ได้หลังจากชำระเงินแล้วเท่านั้น โปรดดูราคา

รับทราบ

การกำเนิดของ siyuan ไม่สามารถแยกออกจากโครงการโอเพ่นซอร์สและผู้มีส่วนร่วมมากมาย โปรดดูที่ซอร์สโค้ดของโครงการ kernel/go.mod, app/package.json และหน้าแรกของโครงการ

การเติบโตของ siyuan ไม่สามารถแยกออกจากความคิดเห็นและการส่งเสริมการขายของผู้ใช้ได้ ขอบคุณสำหรับความช่วยเหลือของทุกคนสำหรับ siyuan ❤️

ผู้ร่วมให้ข้อมูล

ยินดีต้อนรับสู่การเข้าร่วมกับเราและร่วมแบ่งปันโค้ดให้กับ siyuan ด้วยกัน