Skip to content

Commit

Permalink
docs: add dedicated setup page
Browse files Browse the repository at this point in the history
  • Loading branch information
jamiebrynes7 committed Mar 13, 2024
1 parent b5f2e80 commit 6cb50f8
Show file tree
Hide file tree
Showing 5 changed files with 40 additions and 17 deletions.
2 changes: 1 addition & 1 deletion docs/docs/commands/_category_.yml
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
label: Commands
position: 3
position: 4
2 changes: 1 addition & 1 deletion docs/docs/configuration.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 4
sidebar_position: 5
---

# Configuration
Expand Down
16 changes: 2 additions & 14 deletions docs/docs/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,21 +4,9 @@ sidebar_position: 1

# Overview

![](../static/img/social-card.jpg)

The Sync with Todoist Plugin is an _**unofficial**_ plugin that allows you to integrate your Todoist tasks in your Obsidian vault. This integration is mostly one way, from Todoist into Obsidian. There is a limited ability to modify your Todoist tasks, but this functionality will be improved in the future.

This plugin is designed to work on both desktop and mobile Obsidian clients.

<!-- TODO: Add video here -->

## Installation

There are a few steps to getting up and running with this plugin:

1. Install the plugin from Obsidian in the 'Community plugins' tab in the settings.
2. After installing the plugin, enable it.
3. You will get a prompt after enabling the plugin asking for your Todoist API token. You can find this in the [Todoist application settings](https://app.todoist.com/app/settings/integrations/developer).
4. Enter your token and select 'Submit'.

## What's next?

Once you've set up the plugin you can explore adding [query blocks](./query-blocks), look at how to [add tasks from Obsidian](./commands/add-task), or explore the [plugin configuration](./configuration).
2 changes: 1 addition & 1 deletion docs/docs/query-blocks.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 2
sidebar_position: 3
---

# Query Blocks
Expand Down
35 changes: 35 additions & 0 deletions docs/docs/setup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
sidebar_position: 2
---

# Setup

There are a few steps to get up and running with this plugin.

## 1. Install plugin

First we need to install the plugin. You can follow this [handy](https://obsidian.md/plugins?id=todoist-sync-plugin) link to open the plugin's page in Obsidian and install it.

If you prefer to do it manually:

1. Open the settings in Obsidian
2. Select 'Community Plugins' in the sidebar
3. If necessary, turn on community plugins. Make sure you are comfortable with the warnings given to you on this page
4. Select 'Browse' and search for "Todoist Sync"
5. Install the plugin

## 2. Setup API token

Once the plugin is installed, you'll need to enable and do some initial setup.

1. Enable the plugin from Obsidian's setting page
2. You should get a popup asking you to provide your [API token](https://todoist.com/help/articles/find-your-api-token-Jpzx9IIlB).
3. Paste your API token into the prompt
4. The prompt will verify that the token provided is valid and will present you with a checkmark if it is
5. Select 'Submit' to complete the setup

> Note that this token is stored in its own file inside your vault. It can be found at `.obsidian/todoist-token`. If you synchronize your vault, you may choose to explicit ignore this file to avoid the API token leaving your machine. If you choose to do this, you must perform this setup on each device you access your vault on.
## What's next?

Once you've set up the plugin you can explore adding [query blocks](./query-blocks), look at how to [add tasks from Obsidian](./commands/add-task), or explore the [plugin configuration](./configuration).

0 comments on commit 6cb50f8

Please sign in to comment.