Category: Atlassian
-
jira-markup-mode: Emacs major mode for JIRA-markup-formatted text files
Editing Jira markup in a simple browser text pane is a PITA. So I shall give this a try!
-
extracting fields from a Jira “issue” (like a very nice and useful description)? how to get the markup source of the issue description?
No, Jira does not let you read (“per se“) the markup source of an “issue” – that’s why I went this way in the first place 🙄
- http://Jochen.Hayek.name/wp/blog-en/2015/12/02/jira-rest-api/ – using Jira’s REST API: a “…/rest/api/2/issue/…” URL
- http://Jochen.Hayek.name/wp/blog-en/2015/12/22/jq-json-processor/ – how to use
jqfor json-tidying
jq . X.json > X.pretty.json
- http://Jochen.Hayek.name/wp/blog-en/2018/01/17/json-extract-structure/ – extract the structure tree of your JSON data using
jqand a nice command line
jq -c 'path(..)|[.[]|tostring]|join("/")|"."+.' X.pretty.json- the field we are interested in is
fields/description
jq ".fields.description" X.json > X.description.txt
- save the value of that field to a separate file!
- remove the leading and trailing double-quotes!
- replace all
\"with ordinary double-quotes! - remove
\r! - replace
\nwith ordinary new-lines!
jq ".fields.description" X.json | perl -pe 's/^"(.*)"$/$1/; s/\\"/"/g; s/\\r//g; s/\\n/\n/g' > X.description.txt
- …
- looks good, doesn’t it?
-
“Markdown”: further reading
- https://en.wikipedia.org/wiki/Markdown
- https://en.wikipedia.org/wiki/Markup_language
- https://en.wikipedia.org/wiki/Lightweight_markup_language — includes various tables
- http://daringfireball.net/projects/markdown/syntax – where it all began
- http://www.markdowntutorial.com
- http://www.markdowntutorial.com/conclusion/
- https://help.github.com/articles/basic-writing-and-formatting-syntax/
- https://github.github.com/gfm/ – GitHub Flavored Markdown spec
- https://gitlab.com/help/user/markdown – GitLab Flavored Markdown spec (a customer GitLab installation provides (resp. seems to provide) a version with a TOC)
- https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa – Jira and its markup language
- https://en.wikipedia.org/wiki/Creole_(markup)
- http://overapi.com/org-mode – Emacs org-mode and its markup language
Emacs and Markdown:
-
how to export from Atlassian Confluence
- https://confluence.atlassian.com/doc/export-content-to-word-pdf-html-and-xml-139475.html – not that bad 😀
- https://confluence.atlassian.com/display/DOC/Exporting+Confluence+Pages+and+Spaces+to+PDF — “Go to the space and choose Space tools > Content Tools from the bottom of the sidebar”
- I would really like to get the list of target formats extended, but this list isn’t really, really that poor
- my wishlist WRT target formats: mediawiki, DocBook
- my preferred exports: HTML / Custom Export (can be used w/o Confluence), XML / Custom Export (can be reimported to Confluence)
-
where would I re-import an Atlassian Confluence export to?
- Atlassian offers “Confluence in the cloud” for 10 USD/month — not really big money, but for my modest purposes more money than I want to spend
- …
Actually I only want to preserve the “brain work” that I created during my life. I’m not sure I need a running (expensive) Atlassian Confluence for that.