Obsidian به شما امکان می‌دهد یادداشت‌هایتان را به‌راحتی از Notion با استفاده از [[درج‌کننده|افزونه درج‌کننده]] مهاجرت دهید. این کار داده‌های Notion شما را به فایل‌های Markdown بادوام تبدیل می‌کند که می‌توانید به‌صورت آفلاین با Obsidian و بسیاری از اپلیکیشن‌های دیگر استفاده کنید. Obsidian دو روش برای درج داده‌های Notion شما ارائه می‌دهد: 1. **درج از طریق API** کل فضای کاری شما شامل پایگاه‌های داده و فرمول‌ها را حفظ می‌کند که به [[معرفی پایگاه‌ها|پایگاه‌ها]] تبدیل می‌شوند، اما نیاز به توکن یکپارچه‌سازی Notion و اتصال اینترنت دارد. 2. **درج از طریق فایل** پایگاه‌های داده را حفظ نمی‌کند اما نیازی به توکن API یا اتصال اینترنت ندارد. ## درج از طریق API ### ساخت توکن یکپارچه‌سازی API در Notion برای دسترسی به داده‌های Notion از طریق API به یک توکن یکپارچه‌سازی نیاز دارید. این مرحله حدود ۲ دقیقه زمان می‌برد. توکن یک رشته طولانی از اعداد و حروف است که معمولاً با `ntn_...` شروع می‌شود و به شما امکان بارگیری داده‌ها از Notion را می‌دهد. 1. وارد داشبورد [Notion Integrations](https://www.notion.so/profile/integrations/internal) شوید. 2. **New integration** را انتخاب کنید. ![[notion-integration.png#interface]] 2. به یکپارچه‌سازی خود یک نام بدهید، مثلاً «Personal». هر نامی قابل استفاده است. 3. فضای کاری مورد نظر برای استخراج را انتخاب کنید. 4. روی **Save** کلیک کنید و به **Configure integration settings** ادامه دهید. 5. در زبانه **Configuration** توکن API شما در فیلد **Internal Integration Secret** قابل دسترسی است. 6. **Show** و سپس **Copy** را انتخاب کنید. 7. توکن را در جای امنی مانند مدیر گذرواژه ذخیره کنید. ![[notion-token.png#interface]] سپس، به یکپارچه‌سازی خود دسترسی به صفحات و پایگاه‌های داده Notion مورد نظر برای درج بدهید. 1. به زبانه **Access** یکپارچه‌سازی‌ای که ایجاد کردید بروید. 2. روی **Edit access** کلیک کنید. 3. صفحات و پایگاه‌های داده‌ای که می‌خواهید درج کنید را اضافه کنید. اکنون می‌توانید داده‌های خود را با استفاده از Obsidian Importer تبدیل کنید. ### درج داده‌های Notion از طریق API به افزونه رسمی Obsidian [[درج‌کننده]] نیاز دارید که می‌توانید [از اینجا نصب کنید](obsidian://show-plugin?id=obsidian-importer). 1. **[[تنظیمات]]** را باز کنید. 2. به **افزونه‌های انجمن** بروید و [Importer را نصب کنید](obsidian://show-plugin?id=obsidian-importer). 3. افزونه Importer را فعال کنید. 4. افزونه **Importer** را با استفاده از پالت فرمان‌ها یا آیکون نوار ابزار باز کنید. 5. در **قالب فایل** گزینه **Notion (API)** را انتخاب کنید. 6. در **API token**، مقدار **Internal Integration Secret** خود از Notion را بچسبانید. 7. روی **بارگیری** کلیک کنید تا پایگاه‌های داده و صفحاتی که می‌خواهید درج کنید را انتخاب کنید. 8. تنظیمات درج را بررسی و ویرایش کنید. 9. **درج** را انتخاب کنید و صبر کنید تا درج کامل شود. 10. تمام شد! ### محدودیت‌ها > [!info] درج از طریق API جدید است > درج‌کننده API برای Notion جدید است. به دلیل پیچیدگی فضاهای کاری Notion، ممکن است برخی موارد خاص در نظر گرفته نشده باشند. اگر با مشکلاتی در تبدیل مواجه شدید، [یک گزارش باگ ارسال کنید](https://github.com/obsidianmd/obsidian-importer/issues) تا بتوانیم آن را بهبود دهیم. به دلیل محدودیت‌های نرخ API در Notion، درج فضاهای کاری بزرگ ممکن است زمان قابل توجهی ببرد. لطفاً صبور باشید. به دلیل محدودیت‌های API در Notion، برخی داده‌ها در دسترس نیستند یا قابل تبدیل نیستند: - فقط نمای اصلی هر پایگاه داده درج می‌شود. - [منابع داده پیوندشده](https://developers.notion.com/docs/working-with-databases#additional-types-of-databases) درج نمی‌شوند: *«API فعلی Notion از منابع داده پیوندشده پشتیبانی نمی‌کند. هنگام اشتراک‌گذاری پایگاه داده با یکپارچه‌سازی خود، مطمئن شوید که حاوی منبع داده اصلی است!»* - توابع `People`: `name()` و `email()` - توابع `Text`: `style()` و `unstyle()` علاوه بر این، درج‌کننده تغییرات زیر را اعمال می‌کند: - صفحاتی که صفحات فرعی یا پایگاه‌های داده ندارند به‌صورت `[filename].md` به جای `[filename]/[filename].md` درج می‌شوند. - پایگاه‌های داده همیشه به‌صورت پوشه‌هایی با نام `[database name]` و یک فایل `[database name].base` در داخل آن نمایش داده می‌شوند. ## درج از طریق فایل درج از طریق فایل روش جایگزینی برای درج داده‌های Notion شماست. این روش پایگاه‌های داده را حفظ نمی‌کند اما نیازی به توکن API یا اتصال اینترنت ندارد. ### استخراج داده‌ها از Notion برای آماده‌سازی داده‌های خود برای درج، باید کل فضای کاری خود را با استفاده از قالب استخراج HTML در Notion استخراج کنید. توصیه می‌کنیم از استخراج Markdown در Notion استفاده نکنید زیرا داده‌های مهمی را حذف می‌کند. برای استخراج تمام محتوای فضای کاری باید دسترسی مدیریتی به فضای کاری Notion داشته باشید. 1. به **[[تنظیمات]]** در بالای نوار کناری Notion بروید. 2. در بخش **Workspace** گزینه **General** را انتخاب کنید. 3. **Export all workspace content** را پیدا و انتخاب کنید. 4. در **Export format** گزینه **HTML** را انتخاب کنید. 5. **Include everything** را انتخاب کنید. 6. **Create folders for subpages** را فعال کنید. 7. یک فایل `.zip` از طریق ایمیل یا مستقیماً در مرورگر دریافت خواهید کرد. ![[notion-export.png#interface]] ![[notion-export-2.png#interface]] ### درج فایل .zip از Notion به افزونه رسمی Obsidian [[درج‌کننده]] نیاز دارید که می‌توانید [از اینجا نصب کنید](obsidian://show-plugin?id=obsidian-importer). 1. **[[تنظیمات]]** را باز کنید. 2. به **افزونه‌های انجمن** بروید و [Importer را نصب کنید](obsidian://show-plugin?id=obsidian-importer). 3. افزونه Importer را فعال کنید. 4. افزونه **Importer** را با استفاده از پالت فرمان‌ها یا آیکون نوار ابزار باز کنید. 5. در **قالب فایل** گزینه **Notion (.zip)** را انتخاب کنید. 6. فایل `.zip` حاوی فایل‌های Notion مورد نظر برای درج را انتخاب کنید. *توصیه می‌شود تمام Notion خود را یکجا درج کنید تا پیوندهای داخلی به‌درستی تطبیق داده شوند.* 7. _به‌صورت اختیاری_، یک پوشه برای درج انتخاب کنید. صفحات و پایگاه‌های داده Notion شما در داخل این پوشه قرار می‌گیرند. 8. **Save parent pages in subfolders** را فعال کنید تا ساختار Notion حفظ شود. *توجه داشته باشید که در Notion می‌توانید در پوشه‌ها محتوا بنویسید، این در Obsidian امکان‌پذیر نیست و این صفحات به‌عنوان زیرصفحه در داخل پوشه اضافه می‌شوند.* 9. **درج** را انتخاب کنید و صبر کنید تا درج کامل شود. 10. تمام شد! ### عیب‌یابی اگر هنگام درج از Notion با مشکل مواجه شدید: - مطمئن شوید که در Notion از قالب استخراج **HTML** استفاده می‌کنید، **نه Markdown**. - اگر Obsidian در حین درج متوقف به نظر می‌رسد، افزونه‌های انجمن را غیرفعال کنید و دوباره امتحان کنید. با مشکل دیگری مواجه شدید؟ [مخزن Importer](https://github.com/obsidianmd/obsidian-importer/issues) را جستجو کنید تا ببینید آیا دیگران هم آن را تجربه کرده‌اند. #### درج فضاهای کاری بزرگ اگر فضای کاری‌ای با چندین گیگابایت داده درج می‌کنید، فایل استخراج‌شده از Notion ممکن است حاوی فایل‌های `.zip` تو در تو باشد. در این صورت ممکن است پیام خطایی مشابه زیر ببینید: ``` Import failed {id}.zip/{id}-Part-1.zip undefined. ``` اگر این خطا را مشاهده کردید، فایل دریافتی از Notion را از حالت فشرده خارج کنید و سپس فایل‌های تو در توی `Export-{id}-Part-1.zip` را درج کنید.