README file from
GithubGitlab Issues for Obsidian
A plugin for Obsidian to import issues from Gitlab.
Each issue returned from Gitlab is created as an Obsidian note in the specified output directory.
You can create your own template to customise the format of the issue note.
Notes are intended to be READ ONLY, as they will be removed from your Obsidian vault if they no longer are returned by Gitlab.
The latest issues are loaded from Gitlab 30 seconds after Obsidian is started, and then automatically every 15 minutes.
Configuration
You must have a Gitlab account.
- Generate a Gitlab Personal Access Token for the plugin that
has
APIscope included. - Install the plugin through the Obsidian Community Plugins section, and then enable it.
- Enter the Personal Access Token you created at Gitlab into the Token field in the plugin settings.
Example - Listing upcoming deadlines
With the default filter value of due_date=month, the Gitlab API will return all issues that have a Due Date in the
next month.
The plugin will create an Obsidian note file for each issue.
You can then use the excellent DataView Plugin to create lists of upcoming issues to embed anywhere you like in your vault. For example:
dataview
TABLE WITHOUT ID file.link AS "Task", dueDate AS "Due Date" from "@Data/Gitlab Issues"
SORT dueDate
If you then close an issue on Gitlab, or change its due date to be further in the future, the issue will be removed from your vault, and the DataView list will no longer show the issue.
Going Further
Customise the API query
You can use any valid query filter permitted by Gitlab in the "Issues List" endpoint. See the Gitlab API Documentation for all possible options.
Use a custom template
You can customise the template used to create the new notes. Create a note for the template, and specify the path to this note in the plugin settings.
The template must be a valid Handlebars template. See the Handlebars documentation for more information on the syntax.
Currently, the available fields include:
id title description due_date web_url
Bugs
Please report bugs right here in the repository issues section.
Contributions
Contributions are welcome. Please submit a single PR per bug or feature.
License
The plugin code is released under the MIT license. See the LICENSE document for more information.