mirror of
https://github.com/anyproto/docs.git
synced 2025-06-08 05:47:05 +09:00
GITBOOK-535: Import optimizations
This commit is contained in:
Filip Bozicevic
gitbook-bot
parent
e9906e85d4
commit
472a052511
4 changed files with 133 additions and 90 deletions
BIN
.gitbook/assets/image (82).png
Normal file
BIN
.gitbook/assets/image (82).png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 90 KiB |
BIN
.gitbook/assets/image (83).png
Normal file
BIN
.gitbook/assets/image (83).png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 182 KiB |
|
|
@ -15,8 +15,8 @@
|
|||
* [Key](data-and-security/what-is-a-recovery-phrase.md)
|
||||
* [Space](basics/space/README.md)
|
||||
* [Customizing Your Space](basics/space/space-settings.md)
|
||||
* [Collaborate With Others](basics/space/collaboration.md)
|
||||
* [Import & Export](basics/space/import-export.md)
|
||||
* [Collaborate With Others](basics/space/collaboration.md)
|
||||
* [Objects](basics/object-editor/README.md)
|
||||
* [Blocks & Editor](basics/object-editor/blocks.md)
|
||||
* [Ways to Create Objects](basics/object-editor/create-an-object.md)
|
||||
|
|
|
|||
|
|
@ -1,123 +1,166 @@
|
|||
# Import & Export
|
||||
|
||||
You can import or export from your space by navigating to **Anytype > Space Settings > Import / Export Space**. Alternatively, you can simply type “Import” in the Search Menu.
|
||||
### Supported Imports
|
||||
Currently, we support imports from:
|
||||
- **Notion API**
|
||||
Please refer to the [instructions](#notion-import-step-by-step-guide) for details on how to import using the Notion API.
|
||||
You can import or export from your space by navigating to **Anytype > Space Settings > Import / Export Space** in the menu bar:
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (83).png" alt="" width="375"><figcaption></figcaption></figure>
|
||||
|
||||
Alternatively, you can find the Import to / Export Space options under the Integrations section of your [Space Settings](space-settings.md):
|
||||
|
||||
<figure><img src="../../.gitbook/assets/image (82).png" alt="" width="375"><figcaption></figcaption></figure>
|
||||
|
||||
It's also possible to simply type “Import” or “Export” in the Search Menu.
|
||||
|
||||
### Supported File Formats
|
||||
When it comes to file formats, we currently offer support for importing the following:
|
||||
- **MD (Markdown)**: You can import individual `.md` files or a zip file containing multiple Markdown files. Please note that relations are not exported at this time.
|
||||
- **HTML**
|
||||
- **TXT**
|
||||
- **CSV**
|
||||
- **Any-Block**:
|
||||
- **Protobuf**
|
||||
- **JSON**
|
||||
|
||||
#### Import
|
||||
|
||||
We currently offer support for importing the following:
|
||||
|
||||
* **MD (Markdown)**: You can import individual `.md` files or a zip file containing multiple Markdown files. Please note that relations are not exported at this time.
|
||||
* **HTML**
|
||||
* **TXT**
|
||||
* **CSV**
|
||||
* **Any-Block**:
|
||||
* **Protobuf**
|
||||
* **JSON**
|
||||
|
||||
{% hint style="info" %}
|
||||
Because not all Notion features are present in Anytype yet, some Notion data might not end up being imported properly.
|
||||
{% endhint %}
|
||||
|
||||
After your import is done, a new collection should appear in your favorites widget in your sidebar. All of your imported objects should be there.
|
||||
|
||||
When it comes to export formats, we currently offer **Markdown** and **Any-Block** (both Protobuf and JSON).
|
||||
|
||||
### Notion import FAQ
|
||||
|
||||
<details>
|
||||
<summary>Why do I see "page not found" instead of links after importing from Notion to Anytype?</summary>
|
||||
This issue occurs when you have links to pages that are not nested within your Notion workspace structure. These pages may not have been properly connected to the integration during the import, leading to broken links in Anytype.
|
||||
|
||||
**Solution:**
|
||||
- **Check Page Connections:** Ensure that all pages in your Notion workspace are connected before starting the import process. If a page is not properly connected to the integration, it may not import correctly. See the Step 2 of the [Notion Import Step-by-Step Guide](#notion-import-step-by-step-guide) for more details.
|
||||
- **Repeat the import:** If a page did not import, add a missing Connection and repeat the import.
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Why are some files missing after importing from Notion to Anytype?</summary>
|
||||
There are two main reasons for missing files:
|
||||
|
||||
- **Missing Connection:** Make sure that the page containing the files in Notion is properly connected to the integration before import. If this connection is missing, the files may not be imported.
|
||||
- **Slow Internet Connection:** If you have a slow internet connection and a large number of files, the links to these files might expire during the download process, resulting in missing files.
|
||||
|
||||
**Solution:**
|
||||
- **Ensure Proper Connection:** Double-check that all pages and their respective files are connected in Notion before importing.
|
||||
- **Use a Faster Internet Connection:** If possible, use a faster internet connection during the import process to prevent link expiration.
|
||||
- **Manually Add Missing Files:** If files are missing after the import, you may need to manually upload them to Anytype.
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Why did the Notion import to Anytype take so long?</summary>
|
||||
The import process uses the Notion API to ensure data is transferred as accurately as possible. This method, though more reliable than exporting to Markdown, requires multiple queries. Over time, Notion may start rate-limiting these queries, leading to delays.
|
||||
|
||||
**Solution:**
|
||||
- **Plug in Your Device:** Make sure your computer is plugged into a power source during the import.
|
||||
- **Disable Sleep Mode:** Prevent your computer from going to sleep to allow the import process to continue uninterrupted.
|
||||
- **Be Patient:** Allow the import process to run until it completes. It may take some time, especially if there is a large amount of data.
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>I have some other problem with Notion import, or I no longer have access to my Notion workspace</summary>
|
||||
|
||||
If you encounter issues with the Notion import (which works via the Notion API) or you lose full access to your Notion workspace, you can export your workspace from Notion as Markdown & CSV files and import them into Anytype using the Markdown import option.
|
||||
{% hint style="info" %}
|
||||
Be aware that importing via Markdown & CSV files is more lossy compared to using the Notion API. This is because Notion’s way of linking documents and CSV files may not be fully preserved in the Markdown format, potentially leading to loss of structure or links between documents.
|
||||
{% endhint %}
|
||||
|
||||
**Solution:**
|
||||
- **Export from Notion:** In your Notion workspace, export your data as Markdown & CSV files.
|
||||
- **Import into Anytype:** Use Anytype’s Markdown import feature to bring the exported content into your Anytype workspace.
|
||||
</details>
|
||||
#### Export
|
||||
|
||||
We currently offer support for exporting in the following formats:
|
||||
|
||||
* **Markdown**
|
||||
* **Any-Block** (both Protobuf and JSON)
|
||||
|
||||
### Notion Import Step-by-Step Guide
|
||||
|
||||
{% hint style="info" %}
|
||||
Because not all Notion features are implemented in Anytype, some Notion data might not end up being properly imported.
|
||||
{% endhint %}
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Steps</summary>
|
||||
|
||||
#### Step 1
|
||||
**Step 1**
|
||||
|
||||
1. **Open Settings & members.**
|
||||
<figure><img src="../../.gitbook/assets/notion/1-1.png" width="500" alt="Open Settings & members"></figure>
|
||||
1. **Open Settings & members.**\
|
||||
|
||||
2. **Open My Connections and then click Develop or manage integrations.**
|
||||
<figure><img src="../../.gitbook/assets/notion/1-2.png" width="500" alt="Open My Connections"></figure>
|
||||
|
||||
3. **Click New integration or Create new integration.**
|
||||
<figure><img src="../../.gitbook/assets/notion/1-3.png" width="500" alt="Create new integration"></figure>
|
||||
<figure><img src="../../.gitbook/assets/notion/1-1.png" alt="Open Settings & members" width="500"><figcaption></figcaption></figure>
|
||||
2. **Open My Connections and then click Develop or manage integrations.**\
|
||||
|
||||
4. **Select your workspace and set a Name for the integration.**
|
||||
<figure><img src="../../.gitbook/assets/notion/1-4.png" width="500" alt="Set Name for integration"></figure>
|
||||
|
||||
5. **Important!**
|
||||
<figure><img src="../../.gitbook/assets/notion/1-2.png" alt="Open My Connections" width="500"><figcaption></figcaption></figure>
|
||||
3. **Click New integration or Create new integration.**\
|
||||
|
||||
|
||||
<figure><img src="../../.gitbook/assets/notion/1-3.png" alt="Create new integration" width="500"><figcaption></figcaption></figure>
|
||||
4. **Select your workspace and set a Name for the integration.**\
|
||||
|
||||
|
||||
<figure><img src="../../.gitbook/assets/notion/1-4.png" alt="Set Name for integration" width="500"><figcaption></figcaption></figure>
|
||||
5. **Important!**\
|
||||
Go to **Capabilities** and select the following capabilities, then press **Save changes**:
|
||||
- Read content
|
||||
- Read user information
|
||||
<figure><img src="../../.gitbook/assets/notion/1-5.png" width="500" alt="Select capabilities"></figure>
|
||||
|
||||
6. **Copy Internal Integration Secret** for connecting and importing your data.
|
||||
<figure><img src="../../.gitbook/assets/notion/1-6.png" width="500" alt="Copy Internal Integration Secret"></figure>
|
||||
* Read content
|
||||
* Read user information\
|
||||
|
||||
#### Step 2
|
||||
|
||||
<figure><img src="../../.gitbook/assets/notion/1-5.png" alt="Select capabilities" width="500"><figcaption></figcaption></figure>
|
||||
|
||||
6. **Copy Internal Integration Secret** for connecting and importing your data.\
|
||||
|
||||
|
||||
<figure><img src="../../.gitbook/assets/notion/1-6.png" alt="Copy Internal Integration Secret" width="500"><figcaption></figcaption></figure>
|
||||
|
||||
**Step 2**
|
||||
|
||||
**Add the integration to the pages you want to import into Anytype.** Pages will be imported with all children documents.
|
||||
|
||||
1. **Click on the three dots in the upper right corner, then click Connect to (you may need to scroll the menu).** Select your Anytype integration.
|
||||
<figure><img src="../../.gitbook/assets/notion/2-1.png" width="500" alt="Connect to Anytype integration"></figure>
|
||||
1. **Click on the three dots in the upper right corner, then click Connect to (you may need to scroll the menu).** Select your Anytype integration.\
|
||||
|
||||
|
||||
<figure><img src="../../.gitbook/assets/notion/2-1.png" alt="Connect to Anytype integration" width="500"><figcaption></figcaption></figure>
|
||||
2. **Ensure you select all root pages** to avoid broken links in Anytype after the import.
|
||||
3. **Add the Integration to each page's connection** to ensure that the pages and their linked content are imported correctly.\
|
||||
|
||||
3. **Add the Integration to each page's connection** to ensure that the pages and their linked content are imported correctly.
|
||||
|
||||
<figure><img src="../../.gitbook/assets/notion/2-2.png" width="500" alt="Press Confirm"></figure>
|
||||
<figure><img src="../../.gitbook/assets/notion/2-2.png" alt="Press Confirm" width="500"><figcaption></figcaption></figure>
|
||||
|
||||
#### Step 3
|
||||
**Step 3**
|
||||
|
||||
**Finalize the import and ensure a smooth process:**
|
||||
|
||||
1. **Paste your Internal Integration Token into Anytype.**
|
||||
2. **Prepare for a smooth import:**
|
||||
- Use a good internet connection, especially if you have a large number of files.
|
||||
- Keep your computer plugged into power.
|
||||
- Disable sleep mode on your computer to allow the import process to complete without interruptions.
|
||||
|
||||
* Use a good internet connection, especially if you have a large number of files.
|
||||
* Keep your computer plugged into power.
|
||||
* Disable sleep mode on your computer to allow the import process to complete without interruptions.
|
||||
|
||||
</details>
|
||||
|
||||
#### FAQ
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Why do I see "page not found" instead of links after importing from Notion to Anytype?</summary>
|
||||
|
||||
This issue occurs when you have links to pages that are not nested within your Notion workspace structure. These pages may not have been properly connected to the integration during the import, leading to broken links in Anytype.
|
||||
|
||||
**Solution:**
|
||||
|
||||
* **Check Page Connections:** Ensure that all pages in your Notion workspace are connected before starting the import process. If a page is not properly connected to the integration, it may not import correctly. See the Step 2 of the [Notion Import Step-by-Step Guide](import-export.md#notion-import-step-by-step-guide) for more details.
|
||||
* **Repeat the import:** If a page did not import, add a missing Connection and repeat the import.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Why are some files missing after importing from Notion to Anytype?</summary>
|
||||
|
||||
There are two main reasons for missing files:
|
||||
|
||||
* **Missing Connection:** Make sure that the page containing the files in Notion is properly connected to the integration before import. If this connection is missing, the files may not be imported.
|
||||
* **Slow Internet Connection:** If you have a slow internet connection and a large number of files, the links to these files might expire during the download process, resulting in missing files.
|
||||
|
||||
**Solution:**
|
||||
|
||||
* **Ensure Proper Connection:** Double-check that all pages and their respective files are connected in Notion before importing.
|
||||
* **Use a Faster Internet Connection:** If possible, use a faster internet connection during the import process to prevent link expiration.
|
||||
* **Manually Add Missing Files:** If files are missing after the import, you may need to manually upload them to Anytype.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Why did the Notion import to Anytype take so long?</summary>
|
||||
|
||||
The import process uses the Notion API to ensure data is transferred as accurately as possible. This method, though more reliable than exporting to Markdown, requires multiple queries. Over time, Notion may start rate-limiting these queries, leading to delays.
|
||||
|
||||
**Solution:**
|
||||
|
||||
* **Plug in Your Device:** Make sure your computer is plugged into a power source during the import.
|
||||
* **Disable Sleep Mode:** Prevent your computer from going to sleep to allow the import process to continue uninterrupted.
|
||||
* **Be Patient:** Allow the import process to run until it completes. It may take some time, especially if there is a large amount of data.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>I have some other problem with Notion import, or I no longer have access to my Notion workspace</summary>
|
||||
|
||||
If you encounter issues with the Notion import (which works via the Notion API) or you lose full access to your Notion workspace, you can export your workspace from Notion as Markdown & CSV files and import them into Anytype using the Markdown import option.
|
||||
|
||||
Be aware that importing via Markdown & CSV files is more lossy compared to using the Notion API. This is because Notion’s way of linking documents and CSV files may not be fully preserved in the Markdown format, potentially leading to loss of structure or links between documents.
|
||||
|
||||
**Solution:**
|
||||
|
||||
* **Export from Notion:** In your Notion workspace, export your data as Markdown & CSV files.
|
||||
* **Import into Anytype:** Use Anytype’s Markdown import feature to bring the exported content into your Anytype workspace.
|
||||
|
||||
</details>
|
||||
Loading…
Add table
Add a link
Reference in a new issue