Local Development
Informations
If you here youh may be intereset of improve core VuePress.
VuePress is using a combo with Yarn workspaces and Lerna.
Init packages
yarn bootstrap // it will run and install into the root all packages subfolders
yarn bootstrap
will use hoisting. What does it mean for you ?
It will regroup all dependencies in the workspace root and link all packages.
Check the link by running the following command:
ls -la node_modules/@vuepress
You will all symlinks
You have to take care to declare all dependencies inside subFolders package.json. When publish the lib if dependencie from a package is not declare it will just not work.
There is a special package you should have a look is @vuepress/shared-utils that are in typescript.
After install everything it will run yarn tsc
. This command will tell to @vuepress/shared-utils workspace to compile his js.
From here if you are making change inside this package you will have to
run yarn tsc
all the time or run in separate shell yarn run tsc -w
. This will re run tsc at any change from shared-utils
Link
Good from here you have everything ready. You need to link VuePress to your project.
yarn register-vuepress
You will have something like this: success Registered "vuepress".
It will link the package VuePress from packages/vuepress
. You will have access to VuePress cli and packages.
They are declared in the packages/vuepress/package.json
{
"main": "index.js",
///
"bin": {
"vuepress": "cli.js"
}
///
}
Now go to your project and run yarn link vuepress
.
You should have it success Using linked package for "vuepress".
Unlink
You may want to unlink everything. For it in the workspace root folder. Run
yarn unregister-vuepress
Now you can run yarn unlink vuepress
into your project folder.
If everything work properly you should have an error telling you there is no package found called vuepress, if you run yarn link vuepress
in you project folder.
BUGS / QA
You will maybe find some difficulty with link. If you encounter something like There's already a package called "vuepress" registered
.
You already have VuePress registered:
- If you already link VuePress from Link. It’s totally fine. If you make changes because it is symlink you dont have to re run something. You will have to rerun yarn tsc if you update shared-utils package. Nothing more
- If you didn’t do anything. You already have VuePress linked somewhere. What you have to do is deleting folder where you ran
yarn link
oryarn unlink
.
More
You will have interesting commands available: