youngmon/atlassian-qna huggingface dataset:
How to create a confluence page to document REST API similar to Atlassian REST documentation
Asked by Vikash Kumar:

I want to create REST API documentation page in Confluence for custom jira/confluence plugins. What are the combination of/macros I should use to make such confluence documentation page

Fro example: <https://docs.atlassian.com/jira/REST/cloud/#api/2/attachment>

<br />

confluenceRestApi.png  
[](https://community.atlassian.com/t5/Confluence-questions/How-to-create-a-confluence-page-to-document-REST-API-similar-to/qaq-p/454859?attachment-id=5330){#link_119049a20349ca}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/77000/1/confluenceRestApi.png){#display_119049a20349ca_0}


Answers:
author: Steven F Behnke
body: It's not exactly the same but I use a similar format. I was considering creating some **User Macros** to save some of the work --

![image2016-8-2%2015%3A26%3A13](https://community.atlassian.com/t5/image/serverpage/image-id/3259i88098AAD5016CCB5/image-dimensions/510x304?v=v2 "image2016-8-2%2015%3A26%3A13")

![image2016-8-2%2015%3A26%3A55](https://community.atlassian.com/t5/image/serverpage/image-id/3260i544D81F6DEB05648/image-dimensions/284x459?v=v2 "image2016-8-2%2015%3A26%3A55")  
[](https://community.atlassian.com/t5/Confluence-questions/How-to-create-a-confluence-page-to-document-REST-API-similar-to/qaq-p/454859?attachment-id=7503){#link_119049b87f98e8}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/77001/1/image2016-8-2%2015%3A26%3A55.png){#display_119049b87f98e8_0}  
[](https://community.atlassian.com/t5/Confluence-questions/How-to-create-a-confluence-page-to-document-REST-API-similar-to/qaq-p/454859?attachment-id=7504){#link_119049b87f98e8_0}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/77001/2/image2016-8-2%2015%3A26%3A13.png){#display_119049b87f98e8_2}

comments: author: vikash kumar
body: Images you have attached are not visible but looks like you have something useful attached herewith.

Curious to know what are those images, can you please update the broken images.

Note: I asked this question way back when Atlassian answers website was revamping and my question page was lost in the sea so I could not see your answer.


author: Steven F Behnke
body: I embedded the attached images for ease of access.


author: pajics
body: I've used your styling, looks great!

How did you make the highlighted text:  
GET keywords/rest/api/...  


author: Steven Behnke
body: Hmm, that may be a customization I made. I took the same CSS style from 'jiras' monospaced text and applied it to Confluence. However, it's simple CSS, nothing more.
How can you MOVE an existing page so it is an orphan and no longer shows in the left panel navigation tree?
Asked by Wendy Podgursky:

*This question is in reference to Atlassian Documentation: [How to hide pages from showing on the left panel navigation tree in Confluence](https://confluence.atlassian.com/pages/viewpage.action?pageId=420184433)*

The information in this howto is great for new pages, however how can you MOVE an existing page so it is an orphan and no longer shows in the left panel navigation tree?


Answers:
author: Steven F Behnke
body: You can perform a **Move** function and refrain from selecting a Parent Page or you can use the **Space Tools** \> **Reorder Pages** function to drag the page out and above the page structure.

comments: author: Rodney Hughes
body: Or select Browse\>Pages and choose Tree view. Then you just drag the page ++above++ the Home page.

But I agree with Sandy, it seems a weird thing to want to do.

If you want to hide this page from other Users, just select Page Restrictions to only you in the View list - select Ellipsis (three dots) \> Page Restrictions and choose just yourself (and/or others) to add to the Restricted Viewer list - those people will still see it in the left navigation pane but no-one else


author: Wendy Podgursky
body: Thanks Rodney - moving it above the home page did the trick for me. Perfect for 'hiding' pages that house include content, footers etc so they don't appear in the sidebar or pagetree macros.


author: Rodney Hughes
body: Just remember that they do exist as the only way you can see the pages above the Home page is via the Browse\>Pages

That is why I prefer the Page Restrictions as they remain visible to me in the side navigation pane but not visible by others


author: Sandy Johnson
body: The question really is why would want to do this? Is it that you don't want your users to have access to these pages? If so, you can restrict access to those pages, you can move them to another space to which they don't have access (e.g. your personal space).

comments: author: Wendy Podgursky
body: Hey Sandy,

We are using one of our spaces to host user documentation and allowing anonymous access. I wanted to prevent some pages (footers, pages with reusable include content) from appearing in the sidebar or in pagetree macros - looks more professional and makes the site easier to navigate IMHO.


Tags: confluence-cloud

hide

page

side-bar
I cannot edit my macros on my recently created confluence space. I also cannot add macros. Help?
Asked by Sonum Dixit:

*This question is in reference to Atlassian Documentation: [Confluence macros missing in macro browser](https://confluence.atlassian.com/pages/viewpage.action?pageId=429917256)*

Ask your question here...


Answers:
author: Nic Brough -Adaptavist-
body: What errors are you getting, and what does the log file say?

comments: author: Sonum Dixit
body: How do I access the log file?


Tags: cloud

confluence-cloud

documentation

macro
How can I delete draw.io revision history?
Asked by Eli_McGowan:

We have created a relatively large draw.io diagram, and during its creation, the author has saved almost a thousand times (all very minor changes).

The revision history is now huge - is there a way to delete individual revision history entries for draw.io diagrams (similar to deleting revision histories for Confluence pages)?  

Thanks


Answers:
author: Boris
body: It depends if you want to keep only the latest revision or just remove some historical revisions.

**Keep just the latest revision**

Make a copy of your diagram by clicking 'Duplicate' on the macro toolbar in page editor.

That would create a copy from the latest revision. This would keep the original diagram just in case.

**Remove some revisions**

You can remove attachment revisions from the attachments view. You would need to do it for two attachments, XML that stores the diagram contents and the PNG. There could be some 3rd party plugins that can automate this as it can be tedious if you are removing hundreds of revisions, times two.

Keep in mind that drawio macro has a revision parameter which makes it display a particular diagram revision. Browsing through a page history will make it unable to display certain diagram revisions.

In either case, it's best to experiment on a copy of the page, just to be safe.


Tags: confluence-administration

draw.io
left navigation link goes to wrong page
Asked by Mark Simpson:

*This question is in reference to Atlassian Documentation: [Working with Links](https://confluence.atlassian.com/pages/viewpage.action?pageId=771893188)*

I have a landing page that is missing. I have checked the trash and do not see it there. I have checked other trees in the left navigation and do not see it there. The left navigation link for that page points to a blank page in another tree. How can I fix this?


Answers:
author: Rodney Hughes
body: Confluence doesn't allow two pages in the same Space to have the same title so for some reason it is not seeing the correct Parent-Child relationship.

Can you post a screen shot of the navigation tree to help explain? Also of the Browse\>Pages tree view and alphabetical view?


author: Mark Simpson
body: I have a left vertical navigation. I am selecting a top level navigation button which should render a page in the same spot in the tree with it's content. For this particular page it now points to a page with the same title, but under a completely different parent. The content is blank as well. Both of these links are in the same space (A).

There is a third page with the same title as well but it is in space B and not related to this problem as far as I can tell.


author: Rodney Hughes
body: Nope! I'm out of simple ideas .... does the page directory need to be rebuilt/refreshed by the system administrator (if that sort of thing can be done ..???)

To be clear for others to think on :

when you are in Space "A", there is a page shown in the left hand navigation tree.  
That means it must also be listed in Browse\>Pages and the Tree view and appears underneath the Home page somewhere?

But when you click on the page link it goes to a blank page within Space A? i.e. it is a page with no title and no text but a "real" page?

Or do you mean it opens like when you click Create\>Blank Page

How do the direct URLs compare of the starting page and the resulting page?

It might help others spot what is going on if you can post a screen capture of the navigation pane and the blank page and its URL (most PC's have a tool called Snipping Tool to capture selected areas of the screen)


author: Mark Simpson
body: Hi Rodney, Yes I checked both of those it's not there either. I appreciate your suggestion. Any other thoughts?


author: Rodney Hughes
body: I'm not sure

But have you checked Browse\>Space Operations - there are options there for Orphaned and Undefined pages which might need to be cleaned up.


Tags: cloud

confluence-cloud

link
how do I always force a a link to open in a new tab automatically
Asked by Mark Ebersole:

*This question is in reference to Atlassian Documentation: [Working with Links](https://confluence.atlassian.com/pages/viewpage.action?pageId=701434771)*

Ask your question here...


Answers:
author: Nicolas Bourdages
body: You would need to modify the html target. It's rather easy to do actually.

<https://confluence.atlassian.com/confkb/how-to-force-links-to-open-in-a-new-window-213518072.html>


Tags: link
Central acronym repository - would it be popular?
Asked by Bj?rn Tenn?e:

In all the organizations I have been part of, people end up inventing a bunch of three letter acronyms (TLAs! :smile:) that they casually throw around as if everybody else are intimately familiar with them, which is never the case. To counter this people set up competing acronym repositories.

If Confluence had a central repository (per client, obviously), just a simple list of terms and definitions, this could be used to populate tooltips whenever a TLA was used, see below.

Would it be popular? Is it worth the effort?

tooltip.png  
[](https://community.atlassian.com/t5/Confluence-questions/Central-acronym-repository-would-it-be-popular/qaq-p/270195?attachment-id=12607){#link_11868f681ba182}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/45672/1/tooltip.png){#display_11868f681ba182_0}


Answers:
author: TomC
body: Hi,

There are solutions in the Atlassian Marketplace for use cases like this. One I haven't tried but am aware of is this one: <https://marketplace.atlassian.com/plugins/fr.spectrumgroupe.confluence.plugins.glossary/server/overview>

[](https://marketplace.atlassian.com/plugins/fr.spectrumgroupe.confluence.plugins.glossary/server/overview) It appears to be a well-thought out and interesting approach. Might be worth evaluating!

comments: author: Nicholas Conti
body: But does *Glossary* populate tooltips wherever the added terms are used? That useful element appears to be lacking from their tool.


author: Brian McElroy
body: But what is the TLA for Confluence itself?


author: Steven F Behnke
body: A little plug for our plugin :wink: --

Keywords for Confluence allows you to define keywords, acronyms, abbreviations, and more at a Space or a Global level. It allows users to request new keywords as well. We're making great strides to produce a great product and would love to hear thoughts, concerns, desires, or needs.

<https://marketplace.atlassian.com/plugins/com.blackpearlpdm.keywords/server/overview>
How Can I filter .jql results?
Asked by Steven Cannon:

I am using the following query in Confluence to return results from JIRA;

* (issue in linkedissues(*Project Scope* )) and ((project = *P1* ) or (project = *P2*)) and ("Internal/External" = external)  
With the following display settings;

* Display as Table, Columns to display: Key, Release Note Description \& Linked Issues

What I want this to return is a list of all the records which are a part of the *Project Scope* belonging to Projects *P1* \& *P2*which is then displayed with the settings mentioned above.  
The problem I have though is that because I have the Linked Issues column being displayed, this is displaying links to Projects*P1* and *P2* (which is fine), but also to Project *P3* - which I don't want.  
Is there any way to specify which Projects I want displayed, or is it the case that because I have the Linked Issues column being displayed, it will just display ALL the linked issues regardless of the Project they are in?  
Thanks!


Answers:
author: Nicolas Bourdages
body: You would need the ScriptRunner plugin for JIRA (server only), since it allows you to make a subquery in the linkedIssues function. For instance:

issueFunction in linkedIssuesOf("project in (P1, P2)", "project scope")

That will only return issues linked to issues in P1 or P2 through the "project scope" link.


author: Machadinho
body: Hi Steven,

If I understood it right, the query results are OK, but you want to hide some specific information of those results directly on the Confluence table.

I suppose you had a good hunt around and found out that - unfortunately - it's not a current feature, so we'd welcome you to log features and bugs with us directly at [jira.atlassian.com](http://jira.atlassian.com/).

In case of having any questions about Confluence or another Atlassian product that can't be found in the [Atlassian documentation](https://confluence.atlassian.com/), please, let us know right here or rise an issue at [support.atlassian.com](http://support.atlassian.com/).

<br />

Best regards,  
Lucas Machado  
Atlasssian Support


Tags: confluence-administration
License update "XSRF check failed"
Asked by Reinhard Moser:

When i try to update the license of confluence 5.10.3 i get a "XSRF check failed" error. How can i fix this?

Thanks,

Reinhard


Answers:
author: Reinhard Moser
body: Hi Mario,

thank you for your answer. Both did not work.

I am using an apache proxy in front of my confluence - when i connect direct to the confluence server i as able to update the license.

Cheers,

Reinhard

comments: author: Mario G?nter
body: You're welcome.


author: Daniel Petzen
body: Hi

Make sure the Base URL is the same as the URL you're using.

I had the same problem with a freshly installed Confluence 6.0.4 when I tried to apply the license. I started off by using the internal Tomcat webserver on port 8090. I then installed Apache with mod_proxy and was using the confluence.example.com, but hadn't updated the Base URL.

The XSRF failure disappeared as soon as I updated the Base URL.

Cheers,  
Dan

comments: author: Alexander Finger
body: I moved the site to https, after changing the base url the license worked as intended. Thanks for the hint!


author: Mitch Gann
body: Hello, I also have this exact same problem when updating my developer license in Confluence. I will be opening a support ticket regarding this issue.


author: Mario G?nter
body: Hi Reinhard,

you could try to temporary diable XSRF Token: <https://confluence.atlassian.com/bamboo/configuring-xsrf-protection-427624344.html>

But usually you should be able to update license with a valid session / token. Did you try to log out and log in again?

Hope this helps.

Best Regards,   
Mario


Tags: confluence-administration
Single page PDF export format
Asked by Oleg Putilin:

*This question is in reference to Atlassian Documentation: [Advanced PDF Export Customizations](https://confluence.atlassian.com/pages/viewpage.action?pageId=198806890)*

Why do these setting are not applied when exporting a single page?

When exporting via space content tools, it works.  
When exporting from the page's tool menu, it does not.


Answers:
author: Marcel Woschek
body: Look at this page: [Customize Exports to PDF](https://confluence.atlassian.com/doc/customize-exports-to-pdf-190480945.html)

it says:

"PDF customization only applies to space exports (not single page exports via **Tools** \> **Export to PDF** )"

So you won't be able to use it for single pages.

There is a great plugin though, which provides a powerful PDF customization for single pages (and its child pages if you want to):

[Scroll PDF Exporter](https://marketplace.atlassian.com/plugins/com.k15t.scroll.scroll-pdf/server/overview)


author: Steven F Behnke
body: Many of the layouts customizations can be added to the stylesheet instead to generate similar output, thus working around the issue. If you need help with any examples we can probably help a bit there.


Tags: cloud

export

pdf
How can I delete multiple files of the attatchments ?
Asked by GOMIGUN:

*This question is in reference to Atlassian Documentation: [Getting Help and Support](https://confluence.atlassian.com/pages/viewpage.action?pageId=740098452)*

It take too much time to delete one by one.  
Is there any button to open check boxes and delete every files I checked at once?


Answers:
author: Chris Luxmoore
body: ditto, is there an answer to this yet? nothing in the online guide on multiple deletes.


Tags: attachment

confluence-cloud
Why does visual composer come with every theme I pay for then they want me to pay again for the update I just spent 200.00 on themes scam
Asked by loving happy:

Why does visual composer come with every theme I pay for then they want me to pay again for the update I just spent 200.00 on themes scam. this visual composer is crap it makes every site slow and not worth the headache stop requiring it for every theme putting it in the package then trying to charge more just to be able to update it CRAP!


Answers:
author: Steven F Behnke
body: This is the Q\&A forum for Atlassian software products. This is completely unaffiliated with whatever Visual Composer is.


Tags: mistaken-post
lucid charts
Asked by Hilary Yothers:

I am linking to Lucid Charts in my wiki and I need to control the size that they appear. They are importing as a huge bunch of white space and the charts are somewhere in the middle. Can anyone help?


Answers:
author: Steven F Behnke
body: I usually just set the Autosize to **off** (under properties) and use a reasonable size.


author: Hilary Yothers
body: Thank you, but I have tried this and it still doesn't give me the control that I need.
Blog posts by day
Asked by Steve Taylor:

How can we get the Blog posts to sort by day created in the Navigation tree?

We have multiple blog posts per day and would like to sort these posts by year/month/day of creation in the Navigation tree.


Answers:
author: Eleonor Steinweg
body: if you are a blogger and looking for some tips from advanced writers you can [take a peek at this page](http://writemyessay4me.org/blog/essay-hook.html) where authors from USA, Canada and UK will teach you their tiny secrets.


Tags: cloud

confluence-cloud
Confluence notifications destination address incorrect
Asked by Andrew Best:

Morning,

Our confluence instance has some how decided to start delivering notification emails to our "From" address.

The From address in confluence is configured as [donotreply@ourdomain.com.](mailto:donotreply@ourdomain.com.)

When a user modifies a page ive created Confluence is sending the notification to [donotreply@ourdomain.com](mailto:donotreply@ourdomain.com) as well as [myaddress@ourdomain.com.](mailto:myaddress@ourdomain.com.)

Ive been through all the Confluence server and Spaces configs to try and work out where it is getting this destination address configuration from and havent been able to find it.

Anyone got any suggestions?


Answers:
author: Andrew Best
body: I found the root cause of the problem.

The root problem I had was that Confluence edit notifications were ending up in the JIRA inbound mail queue and JIRA was not passing them into tickets. The email just sat in the /var/atlassian/application-data/jira/import/mail/Maildir/new path and consumed disk space.

I could not work out why every time a page edit occurred in Confluence, it was sending the email to the JIRA email address.

Turns out that the a Confluence user account with admin on the Space had the JIRA email address as their contact address in their profile. Therefore, Confluence was notifying the Space admins of the page edit and this was resulting in an email to JIRA. JIRA was ignoring the email because it had the BULK x-header. The mail files would accumulate in the above path.

The fix was to:

* Identify all the accounts in Confluence that had the JIRA email address in their profile.
* Change the address to something else.
* For a couple of the accounts I didnt care about the emails so setup a donotreply address in MS Exchange as per <http://serverfault.com/questions/532576/no-reply-address-in-microsoft-exchange>

comments: author: 105349
body: Awesome, thanks for the detailed writeup on the fix, Andrew! :smile:


author: Andrew Best
body: Hey Cody,

We're using MS Exchange.

Both the links provided refer to JIRA notifications. This problem is for notifications from Confluence.

comments: author: 105349
body: Hey Andrew! I know they're for JIRA, but Confluence uses the same notification backend, so they should be valid fixes.

Is there any chance you can check with your Exchange team to see if anything has changed recently? Specifically regarding anonymous access, forwarding, and handling rules?


author: 105349
body: Hey Andrew!

What do you use as your email server? I've seen similar issues with JIRA and Exchange in the past. Check out these two docs:

[Notification emails don't contain correct From address](https://confluence.atlassian.com/jirakb/notification-emails-don-t-contain-correct-from-address-306348474.html)

[Wrong email sender displayed in notifications from JIRA](https://confluence.atlassian.com/jirakb/wrong-email-sender-displayed-in-notifications-from-jira-719096065.html)

Thanks!
How does one continue paragraph numbering across a dual-column page layout
Asked by Gary Davis:

*This question is in reference to Atlassian Documentation: [Confluence Wiki Markup](https://confluence.atlassian.com/pages/viewpage.action?pageId=251003035)*

How can I continue numbering in a 2-column layout (i.e., list items 1-4 in the left column and 5-9 in the right column)? Every time I try it, the second column begins with item #1.


Answers:
author: Milo Test
body: Unfortunately, you have to use either the Source Editor or the HTML macro to add HTML ol renumbering:

```
&lt;ol start="6"&gt;  &lt;li&gt;Lorem&lt;/li&gt;  &lt;li&gt;Ipsum&lt;/li&gt;  &lt;li&gt;Dolor&lt;/li&gt;&lt;/ol&gt;
```

You might also get the result you need using the "newspaper" style in the Stylesheet or CSS macro to make text in a div macro flow to multiple columns:

```
.columnflow {    -webkit-column-count: 2; /* Chrome, Safari, Opera */    -moz-column-count: 2; /* Firefox */    column-count: 2;}
```


Tags: markup
spring application context
Asked by ace00709:

*This question is in reference to Atlassian Documentation: [Installing Confluence on Windows](https://confluence.atlassian.com/pages/viewpage.action?pageId=255362047)*

Ask your question here...


Answers:
author: Guilherme V.
body: Hi Juan,

If you are having the Spring Application Context while installing Confluence on Windows, you can try the suggested resolutions of the below article:

* [Confluence does not start due to Spring Application context has not been set](https://confluence.atlassian.com/display/CONFKB/Confluence+does+not+start+due+to+Spring+Application+context+has+not+been+set)


Tags: install