vipzhicheng / logseq-plugin-mark-map

This is a plugin for https://github.com/logseq/logseq to provide mindmap support based on https://github.com/markmap/markmap.
282 stars 7 forks source link

How to install if I don't understand "npm" #68

Closed nekodojo closed 7 months ago

nekodojo commented 10 months ago

I have never used or installed npm, nvm or Node. Since I don't use Node and I don't program in JS in my daily life, there is a good chance I am missing some or all necessary context information. The install instructions simply say "npm install" and "npm run".

I don't need to clone this repo and make changes locally. I would like to be able to simply install the plug-in so it works with LogSeq.

I initially tried to install "npm" first with ubuntu apt package manager. "npm" would install and I was able to use "npm install which installed logseq-plugin-mark-map and a lot of dependencies. After this pretty much any "npm" command I gave told me it was giving up because I don't have a package.json file (in my home dir). Remember, my goal is to simply install the software, not to maintain a project directory for it.

I did a bit more reading and I was able to remove apt's version of npm, and install nvm, and node lts version. After this npm-install -g " works to install logseq-plugin-mark-map as a "global" package. This install gives hundreds of lines like npm WARN tar TAR_ENTRY_ERROR ENOENT: no such file or directory. After this I see /home/$USER/.nvm/versions/node/v20.9.0/lib/node_modules/logseq-plugin-mark-map exists but it's a broken link. So my guess is that "global" install won't work for this project or I'm doing it wrong.

If this is already a solved problem and you can point me to a "How to install and run an NPM/node package guide for Dummies" please share the link. If it solves all my problems I can report back.

If you don't really wish to support users with an "easy install" and we should all just download the project directory, cd, and run npm from inside there, let me know that too.

In either case you can probably improve the documentation. If I'm able to figure it out I would be happy to submit a PR for modifying the front page README

vipzhicheng commented 8 months ago

Sorry for the doc missing. Actually if you are not a developer, you need to install this plugin from Logseq Marketplace, and before you do that, you need to go to advanced settings to enable "developer mode"

image

seal308 commented 7 months ago

Sorry for the doc missing. Actually if you are not a developer, you need to install this plugin from Logseq Marketplace, and before you do that, you need to go to advanced settings to enable "developer mode"

image

I am running linux and I turned on developer mode and installed the plugin from the marketplace and the plugin is not working for me.

vipzhicheng commented 7 months ago

@seal308 Which Linux distribution do you use? I am afraid I need to build an environment to test your scenario.

seal308 commented 7 months ago

@seal308 Which Linux distribution do you use? I am afraid I need to build an environment to test your scenario.

lubuntu But i also tried it on a windows computer and have the same issue.

vipzhicheng commented 7 months ago

Not sure what happened. I tries to install Logseq on Windows. It works.

seal308 commented 7 months ago

Not sure what happened. I tries to install Logseq on Windows. It works.

on logseq windows, i have disabled my other plugins, i do not see a mind map icon when i hover:

no mindmap icon

I do not seem to have the icons like in your screenshots on the plugin page:

missing icons

seal308 commented 7 months ago

oh I see the issue. I was expecting to be able to make a mindmap for each block but this plugin seems to only be able to make mindmaps off a page?

date invocation

page mindmap

Is there a way to make a mindmap of specific blocks and not an entire page? So to have a mindmap button each block and not each page?

vipzhicheng commented 7 months ago

For now, there is a way to apply mindmap for specific blocks. You just neet to focus on any block root, and press double ctrl+m. Then you can just render mindmap for the block and it's children.

seal308 commented 7 months ago

For now, there is a way to apply mindmap for specific blocks. You just neet to focus on any block root, and press double ctrl+m. Then you can just render mindmap for the block and it's children.

Thanks so much!