mirror of
https://github.com/decaf-dev/obsidian-vault-explorer.git
synced 2026-07-22 10:10:31 +00:00
docs: add CONTRIBUTING.md
This commit is contained in:
parent
bd3aaf5659
commit
957514f06d
2 changed files with 108 additions and 1 deletions
90
CONTRIBUTING.md
Normal file
90
CONTRIBUTING.md
Normal file
|
|
@ -0,0 +1,90 @@
|
|||
# Contribute to Vault Explorer
|
||||
|
||||
## Installation
|
||||
|
||||
Clone the repository
|
||||
|
||||
```shell
|
||||
git clone https://github.com/decaf-dev/obsidian-dataloom.git
|
||||
```
|
||||
|
||||
Install [Bun.sh](https://bun.sh/) for your operating system
|
||||
|
||||
Change directories to the clone repository
|
||||
|
||||
```shell
|
||||
cd obsidian-vault-explorer
|
||||
```
|
||||
|
||||
Install project dependencies
|
||||
|
||||
```shell
|
||||
bun install
|
||||
```
|
||||
|
||||
Build the project. This will create a `dist` folder
|
||||
|
||||
```shell
|
||||
bun run build
|
||||
```
|
||||
|
||||
Create a symbolic link from the `dist` folder to your Obsidan vault.
|
||||
|
||||
> [!TIP]
|
||||
> I recommend creating a new Obsidian vault just for development. This way, you won't accidentally modify any of your files.
|
||||
|
||||
```shell
|
||||
ln -s <repository-path>/dist <development-vault-path>/.obsidian/plugins/vault-explorer-dev
|
||||
```
|
||||
|
||||
For example
|
||||
|
||||
```shell
|
||||
ln -s /users/decaf-dev/desktop/obsidian-vault-explorer/dist /users/decaf-dev/desktop/dev-vault/.obsidian/plugins/vault-explorer-dev
|
||||
```
|
||||
|
||||
Open your Obsidian vault
|
||||
|
||||
Go to **Community plugins**
|
||||
|
||||
Find **Vault Explorer** and then enable the plugin by switching the toggle.
|
||||
|
||||
> [!NOTE]
|
||||
> You may need to click the **Reload plugins** button
|
||||
|
||||
## Development
|
||||
|
||||
Checkout the `dev` branch and make a child branch off of it.
|
||||
|
||||
```shell
|
||||
git pull dev
|
||||
```
|
||||
|
||||
```shell
|
||||
git checkout dev
|
||||
```
|
||||
|
||||
```shell
|
||||
git checkout -b <your-branch-name>
|
||||
```
|
||||
|
||||
> [!IMPORTANT]
|
||||
> Please make sure that you make a branch off of `dev` instead of `master`. This will help reduce merge conflicts by making sure that you have the latest code changes.
|
||||
|
||||
Run esbuild in development mode
|
||||
|
||||
```shell
|
||||
bun run dev
|
||||
```
|
||||
|
||||
Make some code changes
|
||||
|
||||
Restart Obsidian to see your code changes
|
||||
|
||||
### Pull requests
|
||||
|
||||
Once you have made your changes, push your code to GitHub and make a pull request.
|
||||
|
||||
Please choose `dev` as the branch you want to merge into.
|
||||
|
||||
The pull request will be reviewed. Once it is approved, it will be merged.
|
||||
19
README.md
19
README.md
|
|
@ -8,12 +8,15 @@ Vault Explorer is an [Obsidian.md](https://obsidian.md) plugin for desktop only.
|
|||
|
||||
This plugin is a replacement to some of the functionality found in [Obsidian DataLoom](https://github.com/decaf-dev/obsidian-dataloom).
|
||||
|
||||
## About
|
||||
## Table of contents
|
||||
|
||||
- [Screenshots](#screenshots)
|
||||
- [Installation](#installation)
|
||||
- [Usage](#usage)
|
||||
- [Settings](#settings)
|
||||
- [Contributing](#contributing)
|
||||
- [Support](#support)
|
||||
- [License](#license)
|
||||
|
||||
## Screenshots
|
||||
|
||||
|
|
@ -97,3 +100,17 @@ ln -s <folder-path>/obsidian-vault-explorer/dist <vault-path>/.obsidian/plugins/
|
|||
```
|
||||
|
||||
5. Enable the plugin
|
||||
|
||||
## Contributing
|
||||
|
||||
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
|
||||
|
||||
For detailed information on contributing see our [CONTRIBUTING.md](CONTRIBUTING.md)
|
||||
|
||||
## Support
|
||||
|
||||
[](https://ko-fi.com/P5P5YNX0Y)
|
||||
|
||||
## License
|
||||
|
||||
Vault Explorer is distributed under [MIT License](https://github.com/decaf-dev/obsidian-vault-explorer/blob/master/LICENSE).
|
||||
|
|
|
|||
Loading…
Reference in a new issue