You may want to update your notes to the latest version of Eleventy Notes now and then. Read on to learn how to do that.
Understanding the project structure
Eleventy Notes separates the application code from your notes. This allows you to update the app without losing your notes. The app code is located in the
.app folder. Your notes are located in the root and any subfolder you create.
├── .app/ # App code
│ ├── package.json
│ ├── package-lock.json
│ └── ...
├── My folder/ # Your notes
│ └── Some note.md # Your notes
├── index.md # Your notes
├── My note.md # Your notes
└── app.json # Your config
Unless you want to customize the app in a way that isn't officially supported, you should never need to edit any files in the
.app folder. If you do, you should be aware that you will not be able to update the app anymore or any changes you make will be overwritten when you update the app.
Checking your version
.app/package.json file to find out what version of Eleventy Notes you are currently using:
"version": "0.5.0" // <-- Your current version
Updating the app
The latest version of Eleventy Notes is 0.18.0. If you are using an older version, you should update to the latest version. See the Changelog page for a list of changes in each release. Some releases may contain breaking changes that require you to make changes to your notes or setup.
If you want to proceed with the update, follow these steps:
- Create a backup of your notes
- Delete the
.appfolder in your project
- Download the latest version of Eleventy Notes from GitHub
- Extract the downloaded ZIP file
- Copy the
.appfolder into your project
npm installin the
.appfolder to install the dependencies
- Make any necessary changes to your notes/setup as described on the Changelog page
If you encounter any problems, please open an issue on GitHub.