mirror of
https://github.com/kovetskiy/mark.git
synced 2025-04-24 05:42:40 +08:00
documentation added
This commit is contained in:
parent
17627261d4
commit
b60aaa51d5
38
README.md
Normal file
38
README.md
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
# Mark
|
||||||
|
|
||||||
|
Mark it's tool for syncing your markdown documentation with Atlassian Confluence pages.
|
||||||
|
|
||||||
|
This is very usable if you store documentation to your orthodox software in git
|
||||||
|
repository and don't want to do a handjob with updating Confluence page using
|
||||||
|
fucking tinymce wysiwyg enterprise core editor.
|
||||||
|
|
||||||
|
You can store a user credentials in the configuration file, which should be
|
||||||
|
located in ~/.config/mark with following format:
|
||||||
|
```
|
||||||
|
username = "smith"
|
||||||
|
password = "matrixishere"
|
||||||
|
```
|
||||||
|
|
||||||
|
Mark can read Confluence page URL and markdown file path from another specified
|
||||||
|
configuration file, which you can specify using -c <file> flag. It is very
|
||||||
|
usable for git hooks. That file should have following format:
|
||||||
|
```toml
|
||||||
|
url = "http://confluence.local/pages/viewpage.action?pageId=123456"
|
||||||
|
file = "docs/README.md"
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage:
|
||||||
|
```
|
||||||
|
mark [-u <username>] [-p <password>] -l <url> -f <file>
|
||||||
|
mark [-u <username>] [-p <password>] -c <file>
|
||||||
|
mark -v | --version
|
||||||
|
mark -h | --help
|
||||||
|
```
|
||||||
|
|
||||||
|
- `-u <username>` - Use specified username for updating Confluence page.
|
||||||
|
- `-p <password>` - Use specified password for updating Confluence page.
|
||||||
|
- `-l <url>` - Edit specified Confluence page.
|
||||||
|
- `-f <file>` - Use specified markdown file for converting to html.
|
||||||
|
- `-c <file>` - Specify configuration file which should be used for reading Confluence page URL and markdown file path.
|
||||||
|
- `-v | --version` - Show version.
|
||||||
|
- `-h | --help` - Show help screen and call 911.
|
36
main.go
36
main.go
@ -18,29 +18,39 @@ import (
|
|||||||
const (
|
const (
|
||||||
usage = `Mark
|
usage = `Mark
|
||||||
|
|
||||||
|
Mark it's tool for syncing your markdown files with Atlassian Confluence pages.
|
||||||
|
|
||||||
|
This is very usable if you store documentation to your orthodox software in git
|
||||||
|
repository and don't want to do a handjob with updating Confluence page using
|
||||||
|
fucking tinymce wysiwyg enterprise core editor.
|
||||||
|
|
||||||
You can store a user credentials in the configuration file, which should be
|
You can store a user credentials in the configuration file, which should be
|
||||||
located in ~/.config/mark with following format:
|
located in ~/.config/mark with following format:
|
||||||
user = "smith"
|
username = "smith"
|
||||||
password = "matrixishere"
|
password = "matrixishere"
|
||||||
where 'smith' it's your username, and 'matrixishere' it's your password.
|
where 'smith' it's your username, and 'matrixishere' it's your password.
|
||||||
|
|
||||||
Mark can read Confluence page URL and markdown file path from another specified
|
Mark can read Confluence page URL and markdown file path from another specified
|
||||||
configuration file, which you can specify using -c <file> flag. It is very
|
configuration file, which you can specify using -c <file> flag. It is very
|
||||||
usable for git hooks. That file should have following format:
|
usable for git hooks. That file should have following format:
|
||||||
url = "http://confluence.local/pages/viewpage.action?pageId=123456"
|
url = "http://confluence.local/pages/viewpage.action?pageId=123456"
|
||||||
file = "docs/README.md"
|
file = "docs/README.md"
|
||||||
|
|
||||||
Usage:
|
Usage:
|
||||||
mark [-u <user>] [-p <pass>] -l <url> -f <file>
|
mark [-u <username>] [-p <password>] -l <url> -f <file>
|
||||||
mark [-u <user>] [-p <pass>] -c <file>
|
mark [-u <username>] [-p <password>] -c <file>
|
||||||
|
mark -v | --version
|
||||||
|
mark -h | --help
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
-u <user> Use specified username for updating Confluence page.
|
-u <username> Use specified username for updating Confluence page.
|
||||||
-p <pass> Use specified password for updating Confluence page.
|
-p <password> Use specified password for updating Confluence page.
|
||||||
-l <url> Edit specified Confluence page.
|
-l <url> Edit specified Confluence page.
|
||||||
-f <file> Use specified markdown file for converting to html.
|
-f <file> Use specified markdown file for converting to html.
|
||||||
-c <file> Specify configuration file which should be used for reading
|
-c <file> Specify configuration file which should be used for reading
|
||||||
Confluence page URL and markdown file path.
|
Confluence page URL and markdown file path.
|
||||||
|
-h --help Show this screen and call 911.
|
||||||
|
-v --version Show version.
|
||||||
`
|
`
|
||||||
)
|
)
|
||||||
|
|
||||||
@ -52,7 +62,7 @@ type PageInfo struct {
|
|||||||
}
|
}
|
||||||
|
|
||||||
func main() {
|
func main() {
|
||||||
args, err := docopt.Parse(usage, nil, true, "mark 1.0", true, true)
|
args, err := docopt.Parse(usage, nil, true, "mark 1.0", false, true)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
panic(err)
|
panic(err)
|
||||||
}
|
}
|
||||||
|
Loading…
x
Reference in New Issue
Block a user