adamsiwiec / hexagon Goto Github PK

View Code? Open in Web Editor NEW

55.0 3.0 10.0 217 KB

A package manager for Hexo

JavaScript 100.00%

hexo hexo-plugin package-manager emojis

hexagon's Introduction

Hexagon

A package manager for Hexo.

Prerequisites

NodeJS
Git

Getting Started

Install:

$ npm install -g hexagon-cli

You can use it by running:

$ hexagon --help

# or

$ hexa --help # For the minimalists out there

Usage

For Hexagon to work properly, make sure you are in your project's root directory.

To install a plugin:

Pass the -p or --plugin flag or just plugin
Pass the npm package[s] name

$ hexagon --plugin hexo-generator-github
$ hexagon -p hexo-generator-github
$ hexagon plugin hexo-generator-github

To install a theme:

Pass the -t or --theme flag or just theme
Pass the Github abbreviation, e.g adamsiwiec/hexagon-theme

$ hexagon --theme adamsiwiec/hexagon-theme
$ hexagon -t adamsiwiec/hexagon-theme
$ hexagon theme adamsiwiec/hexagon-theme

To list all themes and plugins

$ hexagon list

For more commands:

$ hexagon --help

Contributing

Please submit Issues or Pull Requests to continue the development of Hexagon

Versioning

We use SemVer for versioning. For the versions available, see the NPM site or the releases.

Authors

Adam Siwiec - Initial work, Website

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License

hexagon's People

Contributors

Stargazers

Watchers

Forkers

forkedreposbak poldiwa kublaj raya-studio danielxsm rajasardar kang-kk alice-space kafka1314

hexagon's Issues

win10 x64+nodejs+git+hexo+hexagon

everything is good and I can use hexagon to install a theme

but I can't use hexagon to install any plugin

for example:

hexagon -p hexo-hey

× Installing packages
⚠️ Uh Oh! Something went wrong check npm-debug.log for more info

Unable to replicate theme option

After downloading hexo-cli I downloaded hexagon then hexo-server, and hexo-admin globally. I then run

hexo init blog-test
cd blog-test/
hexagon theme ppoffice/hexo-theme-hueman

but get the following traceback


⬡

Error: spawn git ENOENT
    at exports._errnoException (util.js:870:11)
    at Process.ChildProcess._handle.onexit (internal/child_process.js:178:32)
    at onErrorNT (internal/child_process.js:344:16)
    at nextTickCallbackWith2Args (node.js:441:9)
    at process._tickCallback (node.js:355:17)
    at Function.Module.runMain (module.js:444:11)
    at startup (node.js:136:18)
    at node.js:966:3

Command taking just the first character of the argument

I can't install anything, it does this:
hexagon -t klugjo/hexo-theme-alpha-dust

⬡

⠋ Cloning themes
Git#then is deprecated after version 1.72 and will be removed in version 2.x
Please switch to using Git#exec to run arbitrary functions as part of the command chain.

⠧ Cloning themesCloning into 'k'...
remote: Not Found
fatal: repository 'https://github.com/k/' not found

⠼ Cloning themes^C

Error when install theme

I get error message : when call "sudo hexagon -t ppoffice/hexo-theme-icarus"
hexagon-cli/node_modules/async/dist/async.js:3686
task(rest(function (err, args) {

Auto remove the "hexo-theme-" prefix when install a theme and support custom git origin

I'm a Chinese so the issues grammar in use might not correctly.

When people install a theme they usually use Git command like this to remove the prefix:

git clone https://{origin_url}/{author}/{repo}.git themes/{theme_name_without_prefix}

This way they can type "theme name" instead "hexo-theme-theme name" on the configuration file _config.yml.

And although mostly theme are publish on GitHub, but I think it's also need to support other Git remote origin and custom branch,so could you support for this? PLZ

Tests wanted!

I'm not the best at writing tests, so I will leave it up to the community to decide what to do with testing, but it needs to get done so somebody volunteer to write the tests.

[BUG] Yarn usage

I installed hexagon with yarn, however, I now get errors

hexa -p hexo-admin
                                   
⬡                             
                              
✖ Installing packages         
⚠️ Uh Oh! Something went wrong check npm-debug.log for more info

I also cannot find the npm-debug.log

The same command works with yarn

yarn add hexo-admin

Create a CONTRIBUTING.md

I'm a newbie, and I don't know where and how to start on contributing to the project.

Feature Request: Install themes/plugins as a git submodules

Hey, since its expected that you would use git to repo your entire hexo project, it would be great if this tool could automatically setup installed themes/plugins as submodules to workaround the repo-inside-a-repo conflict. Some more info here:

https://git-scm.com/docs/git-submodule

What do you think?