package main import ( "bytes" "fmt" "io/ioutil" "os" "path/filepath" "github.com/kovetskiy/godocs" "github.com/kovetskiy/mark/pkg/confluence" "github.com/kovetskiy/mark/pkg/log" "github.com/kovetskiy/mark/pkg/mark" "github.com/kovetskiy/mark/pkg/mark/includes" "github.com/kovetskiy/mark/pkg/mark/macro" "github.com/kovetskiy/mark/pkg/mark/stdlib" "github.com/reconquest/karma-go" ) const ( usage = `mark - tool for updating Atlassian Confluence pages from markdown. 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" base_url = "http://confluence.local" where 'smith' it's your username, 'matrixishere' it's your password and 'http://confluence.local' is base URL for your Confluence instance. Mark understands extended file format, which, still being valid markdown, contains several metadata headers, which can be used to locate page inside Confluence instance and update it accordingly. File in extended format should follow specification: There can be any number of 'Parent' headers, if mark can't find specified parent by title, it will be created. Also, optional following headers are supported: * - (default) article: content will be put in narrow column for ease of reading; - plain: content will fill all page; Mark supports Go templates, which can be included into article by using path to the template relative to current working dir, e.g.: Templates may accept configuration data in YAML format which immediately follows include tag: Mark also supports macro definitions, which are defined as regexps which will be replaced with specified template: Capture groups can be defined in the macro's which can be later referenced in the using ${} syntax, where is number of a capture group in regexp (${0} is used for entire regexp match), for example: By default, mark provides several built-in templates and macros: * template 'ac:status' to include badge-like text, which accepts following parameters: - Title: text to display in the badge - Color: color to use as background/border for badge - Grey - Yellow - Red - Blue - Subtle: specify to fill badge with background or not - true - false See: https://confluence.atlassian.com/conf59/status-macro-792499207.html * template 'ac:jira:ticket' to include JIRA ticket link. Parameters: - Ticket: Jira ticket number like BUGS-123. * macro '@{...}' to mention user by name specified in the braces. Usage: mark [options] [-u ] [-p ] [-k] [-l ] -f mark [options] [-u ] [-p ] [-k] [-b ] -f mark [options] [-u ] [-p ] [-k] [-n] -c mark -v | --version mark -h | --help Options: -u Use specified username for updating Confluence page. -p Use specified token for updating Confluence page. -l Edit specified Confluence page. If -l is not specified, file should contain metadata (see above). -b --base-url Base URL for Confluence. Alternative option for base_url config field. -f Use specified markdown file for converting to html. -k Lock page editing to current user only to prevent accidental manual edits over Confluence Web UI. --dry-run Resolve page and ancestry, show resulting HTML and exit. --compile-only Show resulting HTML and don't update Confluence page content. --debug Enable debug logs. --trace Enable trace logs. -h --help Show this screen and call 911. -v --version Show version. ` ) func main() { args, err := godocs.Parse(usage, "mark 2.0", godocs.UsePager) if err != nil { panic(err) } var ( targetFile, _ = args["-f"].(string) compileOnly = args["--compile-only"].(bool) dryRun = args["--dry-run"].(bool) editLock = args["-k"].(bool) ) log.Init(args["--debug"].(bool), args["--trace"].(bool)) config, err := LoadConfig(filepath.Join(os.Getenv("HOME"), ".config/mark")) if err != nil { log.Fatal(err) } creds, err := GetCredentials(args, config) if err != nil { log.Fatal(err) } api := confluence.NewAPI(creds.BaseURL, creds.Username, creds.Password) markdown, err := ioutil.ReadFile(targetFile) if err != nil { log.Fatal(err) } meta, markdown, err := mark.ExtractMeta(markdown) if err != nil { log.Fatal(err) } stdlib, err := stdlib.New(api) if err != nil { log.Fatal(err) } templates := stdlib.Templates var recurse bool for { templates, markdown, recurse, err = includes.ProcessIncludes( markdown, templates, ) if err != nil { log.Fatal(err) } if !recurse { break } } macros, markdown, err := macro.ExtractMacros(markdown, templates) if err != nil { log.Fatal(err) } macros = append(macros, stdlib.Macros...) for _, macro := range macros { markdown, err = macro.Apply(markdown) if err != nil { log.Fatal(err) } } if dryRun { compileOnly = true _, _, err := mark.ResolvePage(dryRun, api, meta) if err != nil { log.Fatalf(err, "unable to resolve page location") } } if compileOnly { fmt.Println(mark.CompileMarkdown(markdown, stdlib)) os.Exit(0) } if creds.PageID != "" && meta != nil { log.Warning( `specified file contains metadata, ` + `but it will be ignored due specified command line URL`, ) meta = nil } if creds.PageID == "" && meta == nil { log.Fatal( `specified file doesn't contain metadata ` + `and URL is not specified via command line ` + `or doesn't contain pageId GET-parameter`, ) } var target *confluence.PageInfo if meta != nil { parent, page, err := mark.ResolvePage(dryRun, api, meta) if err != nil { log.Fatalf( karma.Describe("title", meta.Title).Reason(err), "unable to resolve page", ) } if page == nil { page, err = api.CreatePage(meta.Space, parent, meta.Title, ``) if err != nil { log.Fatalf( err, "can't create page %q", meta.Title, ) } } target = page } else { if creds.PageID == "" { log.Fatalf(nil, "URL should provide 'pageId' GET-parameter") } page, err := api.GetPageByID(creds.PageID) if err != nil { log.Fatalf(err, "unable to retrieve page by id") } target = page } attaches, err := mark.ResolveAttachments(api, target, ".", meta.Attachments) if err != nil { log.Fatalf(err, "unable to create/update attachments") } markdown = mark.CompileAttachmentLinks(markdown, attaches) html := mark.CompileMarkdown(markdown, stdlib) { var buffer bytes.Buffer err := stdlib.Templates.ExecuteTemplate( &buffer, "ac:layout", struct { Layout string Body string }{ Layout: meta.Layout, Body: html, }, ) if err != nil { log.Fatal(err) } html = buffer.String() } err = api.UpdatePage(target, html) if err != nil { log.Fatal(err) } if editLock { log.Infof( nil, `edit locked on page %q by user %q to prevent manual edits`, target.Title, creds.Username, ) err := api.RestrictPageUpdates( target, creds.Username, ) if err != nil { log.Fatal(err) } } log.Infof( nil, "page successfully updated: %s", creds.BaseURL+target.Links.Full, ) fmt.Println( creds.BaseURL + target.Links.Full, ) }