mirror of
				https://github.com/kovetskiy/mark.git
				synced 2025-11-04 14:27:36 +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