diff options
author | 0neGal <mail@0negal.com> | 2021-12-30 20:35:08 +0100 |
---|---|---|
committer | 0neGal <mail@0negal.com> | 2021-12-30 20:35:08 +0100 |
commit | 823d34f6f41c65c7b1cb8e55bd429b9efc4f3878 (patch) | |
tree | 149a7274cc024c62a6625704cde0d095db53e6a3 | |
parent | 9d8ceea77b6f172f0c055c0061bc07e6f45c0d2d (diff) | |
download | Viper-823d34f6f41c65c7b1cb8e55bd429b9efc4f3878.tar.gz Viper-823d34f6f41c65c7b1cb8e55bd429b9efc4f3878.zip |
added a lovely man page
Simply build it with "npm run man"
-rw-r--r-- | docs/viper.1 | 58 | ||||
-rw-r--r-- | docs/viper.1.md | 54 | ||||
-rw-r--r-- | package-lock.json | 36 | ||||
-rw-r--r-- | package.json | 6 |
4 files changed, 153 insertions, 1 deletions
diff --git a/docs/viper.1 b/docs/viper.1 new file mode 100644 index 0000000..0b399b8 --- /dev/null +++ b/docs/viper.1 @@ -0,0 +1,58 @@ +.TH "VIPER" "1" "December 2021" "" "" +.SH "NAME" +\fBviper\fR \- update and manage northstar +.SH SYNOPSIS +.P +\fBviper\fP [<optional>\|\.\.\.] +.SH DESCRIPTION +.P +Viper is a program made to make updating and launching Northstar a lot easier\. It has both a CLI and GUI tool, specifying no command line arguments opens the latter\. +.SH OPTIONS +.P +\fB\-\-help\fP + Shows a brief message of all the options and what they do\. +.P +\fB\-\-version\fP + Various versions numbers for Node, Electron, Viper and so on\. +.P +\fB\-\-cli\fP + Forces the CLI to activate, meaning the GUI will never run\. + What purpose this has I frankly do not know\. +.P +\fB\-\-update\fP + Updates Northstar, this uses your \fBviper\.json\fP to determine the location, it also won't try to update if the installed version of Northstar is already the newest, if you must re\-install Northstar you can delete the \fBns_version\.txt\fP file in the game path\. +.P +\fB\-\-launch\fP=<version> + Launches Northstar, this is currently only supported on Windows\. + If you must launch Vanilla you can run \fB\-\-launch=vanilla\fP +.P +\fB\-\-setpath\fP=<absolute\-path> + Sets the game path, this'll change the \fBgamepath\fP variable in your \fBviper\.json\fP, note that it only takes in absolute paths and not relative ones\. +.SH CONFIGURATION +.P +All configuration takes place in your \fBviper\.json\fP file, this file may be in various locations depending on your platform, for Linux you're likely to find it at: +.RS 0 +.IP \(bu 2 +\fB$XDG_CONFIG_HOME/viper\.json\fP +.IP \(bu 2 +\fB~/\.config/viper\.json\fP + +.RE +.P +On Windows it's likely to be in \fB%APPDATA%\\viper\.json\fP +.P +All configuration is done by Viper itself, the locale is auto set when the GUI launches through your systems locale, the gamepath is selected with \fB\-\-setpath\fP or in the GUI\. +.SH BUGS +.P +Report bugs on the GitHub issues page, and feel free to make a pull request if you also have the fix to the bug\. +.SH AUTHORS +.P +Main contributors/maintainers to the project: +.RS 0 +.IP \(bu 2 +0neGal mail@0negal\.com +.IP \(bu 2 +Rémy Raes contact@remyraes\.com + +.RE + diff --git a/docs/viper.1.md b/docs/viper.1.md new file mode 100644 index 0000000..fa531c3 --- /dev/null +++ b/docs/viper.1.md @@ -0,0 +1,54 @@ +viper(1) -- update and manage northstar +======================================= + +## SYNOPSIS + +`viper` [<optional>...] + +## DESCRIPTION + +Viper is a program made to make updating and launching Northstar a lot easier. It has both a CLI and GUI tool, specifying no command line arguments opens the latter. + +## OPTIONS + +`--help` + Shows a brief message of all the options and what they do. + +`--version` + Various versions numbers for Node, Electron, Viper and so on. + +`--cli` + Forces the CLI to activate, meaning the GUI will never run. + What purpose this has I frankly do not know. + +`--update` + Updates Northstar, this uses your `viper.json` to determine the location, it also won't try to update if the installed version of Northstar is already the newest, if you must re-install Northstar you can delete the `ns_version.txt` file in the game path. + +`--launch`=<version> + Launches Northstar, this is currently only supported on Windows. + If you must launch Vanilla you can run `--launch=vanilla` + +`--setpath`=<absolute-path> + Sets the game path, this'll change the `gamepath` variable in your `viper.json`, note that it only takes in absolute paths and not relative ones. + +## CONFIGURATION + +All configuration takes place in your `viper.json` file, this file may be in various locations depending on your platform, for Linux you're likely to find it at: + + * `$XDG_CONFIG_HOME/viper.json` + * `~/.config/viper.json` + +On Windows it's likely to be in `%APPDATA%\viper.json` + +All configuration is done by Viper itself, the locale is auto set when the GUI launches through your systems locale, the gamepath is selected with `--setpath` or in the GUI. + +## BUGS + +Report bugs on the GitHub issues page, and feel free to make a pull request if you also have the fix to the bug. + +## AUTHORS + +Main contributors/maintainers to the project: + + * 0neGal <mail@0negal.com> + * Rémy Raes <contact@remyraes.com> diff --git a/package-lock.json b/package-lock.json index 116bb7e..fc3dc60 100644 --- a/package-lock.json +++ b/package-lock.json @@ -10,6 +10,7 @@ "license": "GPL-3.0-or-later", "dependencies": { "follow-redirects": "^1.14.6", + "marked-man": "^0.7.0", "request": "^2.88.2", "unzipper": "^0.10.11" }, @@ -2432,6 +2433,29 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/marked": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/marked/-/marked-0.7.0.tgz", + "integrity": "sha512-c+yYdCZJQrsRjTPhUx7VKkApw9bwDkNbHUKo1ovgcfDjb2kc8rLuRbIFyXL5WOEUwzSSKo3IXpph2K6DqB/KZg==", + "peer": true, + "bin": { + "marked": "bin/marked" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/marked-man": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/marked-man/-/marked-man-0.7.0.tgz", + "integrity": "sha512-zxK5E4jbuARALc+fIUAanM2njVGnrd9YvKrqoDHUg2XwNLJijo39EzMIg59LecHBHsIHNtPqepqnJp4SmL/EVg==", + "bin": { + "marked-man": "bin/marked-man" + }, + "peerDependencies": { + "marked": "^0.7.0" + } + }, "node_modules/matcher": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/matcher/-/matcher-3.0.0.tgz", @@ -5493,6 +5517,18 @@ "semver": "^6.0.0" } }, + "marked": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/marked/-/marked-0.7.0.tgz", + "integrity": "sha512-c+yYdCZJQrsRjTPhUx7VKkApw9bwDkNbHUKo1ovgcfDjb2kc8rLuRbIFyXL5WOEUwzSSKo3IXpph2K6DqB/KZg==", + "peer": true + }, + "marked-man": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/marked-man/-/marked-man-0.7.0.tgz", + "integrity": "sha512-zxK5E4jbuARALc+fIUAanM2njVGnrd9YvKrqoDHUg2XwNLJijo39EzMIg59LecHBHsIHNtPqepqnJp4SmL/EVg==", + "requires": {} + }, "matcher": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/matcher/-/matcher-3.0.0.tgz", diff --git a/package.json b/package.json index 5e19ef4..ca02932 100644 --- a/package.json +++ b/package.json @@ -18,6 +18,7 @@ "scripts": { "start": "npx electron src/index.js", "debug": "npx electron src/index.js --debug", + "man": "npx marked-man docs/viper.1.md > docs/viper.1", "build": "npx electron-builder --win nsis --linux appimage" }, "repository": { @@ -26,10 +27,13 @@ }, "author": "0neGal", "license": "GPL-3.0-or-later", - "bugs": {"url": "https://github.com/0neGal/viper/issues"}, + "bugs": { + "url": "https://github.com/0neGal/viper/issues" + }, "homepage": "https://github.com/0neGal/viper#readme", "dependencies": { "follow-redirects": "^1.14.6", + "marked-man": "^0.7.0", "request": "^2.88.2", "unzipper": "^0.10.11" }, |