youngmon/atlassian-qna huggingface dataset:
Tech Support Documentation Format
Asked by Richard Lucas:

Hello all,

I am currently working on a project that involves converting much of our tech support documentation into confluence. This involves copying scripts over, .jars, and thing of that nature.

It seems like it would be cumbersome to just add our scripts (.txt format) as attachments to confluence.

I would think this would be a regular use of confluence and would appreciate if anyone could point me in the direction of a format to go off of.

Thank you.


Answers:
author: Jeremy Largman
body: Documentation is definitely one of the core uses for Confluence. Check out [Developing Technical Documentation on Confluence](https://confluence.atlassian.com/display/DOC/Developing+Technical+Documentation+on+Confluence+Wiki) as a guide. Also, Sarah Maddox, one of our Technical Writers, has a [book on the subject](http://www.amazon.com/Confluence-Tech-Comm-Chocolate-extraordinaire/dp/1937434001)!

As for copying, there are a couple tools to start with. The [Universal Wiki Converter](https://marketplace.atlassian.com/plugins/com.atlassian.uwc) will convert content from another Wiki, but I think you really want the [rest API](http://docs.atlassian.com/atlassian-confluence/REST/3.2/), the [command line interface](https://bobswift.atlassian.net/wiki/display/CSOAP/Confluence+Command+Line+Interface), or possibly the [SOAP API](https://developer.atlassian.com/display/CONFDEV/Confluence+XML-RPC+and+SOAP+APIs). The CLI is particularly user-friendly (as far as command line utilities go!) but if you want your own integration points, look at the rest or soap api's.


author: Harry Chan
body: Hi, I'd recommend the Confluence Code Block Macro <https://confluence.atlassian.com/display/DOC/Code+Block+Macro> for any scripts that you may have.
Horizontal Rule not showing?
Asked by Brian Dunk:

Why when i add the 4 dashes required to show the horizontal rule it will not render. Also, when I use the RT editor and select the Insert - Horizontal Rule option nothing is displayed.

Confluence 4.2.1

FireFox 16.0.1


Answers:
author: Giuliano C.
body: #### Hello, {#toc-hId--159500743}

*

  #### Remember that It does not work if you press space. {#toc-hId--130871592}

* Make sure that the dashes are on a separate line from the rest of the text.
* you may be experiencing <https://jira.atlassian.com/browse/CONF-26393>

If the problem still persists and you still experience it, please, feel free to raise a ticket through <https://support.atlassian.com>

Hope it helps you.

Kind Regards


author: Sherry Umlah
body: It's difficult not being able to edit the source of the document. I've tried adding empty space before and after the horizontal rule and it won't show up, but if I inspect and put a margin on the \<hr\> tag - eh voila! It seems like you would want to clear all as part of the hr styling....  
![hr.gif](https://community.atlassian.com/t5/image/serverpage/image-id/19894iFD699DE97E95C81D/image-size/large?v=v2&px=999 "hr.gif")
Application link trust setup between JIRA and Confluence via SSL is failing to recognize each other
Asked by Olivier Miranda:

We have a setup where Confluence and JIRA are running on the same server which is setup for HTTPS traffic only. Additionally, a proxy is setup where Confluence HTTPS traffic is sent through port 8443 and JIRA traffic is sent through port 8009 which is using the ajp protocol. This was necessary due to both of the services running on the same server.

HTTPS access to both services work fine. The problem is the trust relationship setup between Confluence and JIRA is not recognizing each other even though keystore file is setup for JIRA and Confluence via the tomcat server.xml file.

The error message I'm getting from Confluence is:

Application JIRA seems to be offline. Click here to Relocate.

Please let me know what options I have in resolving this issue.


Answers:
author: GuilhermeA
body: Hello Olivier,

It seems that the Confluence or JIRA is not getting the correct certificate from your server. This means that you need to import it inside your machine for either of one to trust each other.

There is article which explains how to do it:

<https://confluence.atlassian.com/pages/viewpage.action?pageId=296093119>

Basically would be add this to the JAVA_OPTS:

```
-Djavax.net.ssl.trustStore=C:\Users\admin\.keystore -Djavax.net.ssl.trustStorePassword=changeit
```

Hope this helps!

Cheers,

Guilherme


Tags: jira
Confluence and permissions for comments
Asked by Mik:

Hi Guys.

Customer would like the opportunity to add kommentarerer per space in Confluence.

The comments will not be visible to all users - but could be concealed for group / evt individual users - that provide access per group or individual users to view comments, add comments, or delete comments.

Is there any way to sove that needs ?  
Thanks a lot  
Mik.


Answers:
author: Septa Cahyadiputra
body: Hi there,

Confluence comment permission is configured under [space permission.](https://confluence.atlassian.com/display/DOC/Space+Permissions+Overview) There you could specified which user can add and remove a comment on the page. However, Confluence does not have a feature to hide the comment section on the page to certain user or group.

However, the following workaround might be able to help you in achieving your purpose. Please note that the steps below could only hide the whole comment section, not an individual comment.

1. Install [CustomWare Visibility Plugin](https://marketplace.atlassian.com/plugins/net.customware.confluence.plugin.visibility)
2. Access your administration page
3. Navigate to "User Macros" under the "Configuration" section
4. Create a User Macro
5. Configure the Macro Name and Title (Example: hide)
6. Choose "No Macro Body" as the definition of the macro
7. Under the template input the following lines  

   ```
   <style>#comments-section{display:none;}</style>
   ```

8. Save
9. Go to the page necessary
10. Create a "\<tt\>show-if" macro with the configured groups that are restricted to see the comments section\</tt\>
11. \<tt\>Put the created user macro inside the "show-if"\</tt\>macro
12. Saved

Hope it helps.

Cheers,  
Septa Cahyadiputra


author: Irina_Bel_Stiltsoft_
body: Hi [@Mik](/t5/user/viewprofilepage/user-id/1013320) ,

It seems like this question is water under the bridge, but my answer is still relevant.

The [Talk Advanced Inline Comments for Confluence](https://marketplace.atlassian.com/apps/978531/talk-advanced-inline-comments?hosting=datacenter&tab=overview) app has the functionality to set visibility permissions. That means if you go to the Space tools and choose Talk permissions tab, you can specify certain users or groups that can see inline comments. Other users that have Comment permission over the space can leave talk inline comments. But they will be visible only to the people mentioned in Talk Permissions.

![Talk Space Permissions.png](https://community.atlassian.com/t5/image/serverpage/image-id/191822iDC106FDE32F0BF8E/image-size/large?v=v2&px=999 "Talk Space Permissions.png")


Tags: permission

space
How can i create a news scroll in confluence 3.5?
Asked by Avinash:

Hi,

I have an events section in my confluence page. I was wondering if its possible to make an events scroller out of the information using javascript? Any solutions? plz help.

Thanks,

Avinash


Answers:
author: JohnA
body: Hi Avinash,

My first thought when reading your request is that you might be interested in the News Ticker plugin by App Fusions: <https://marketplace.atlassian.com/plugins/com.appfusions.confluence.plugins.newsticker>

It is a commercial plugin, although it is still quite reasonably priced, so maybe this might be an option for you?

All the best,  
John

comments: author: Avinash
body: Hi John,

I did look into that option at first but i wld prefer if i dont have to purchase it. I wanted to use javascript as im familiar with it but im having issues calling the script while using confluence. Thanks for your suggestion.

Avinash


Tags: javascript
Is it possible to make a Space isolated for testing?
Asked by Bristow:

The idea is that I want to create a Test Space in which users can go in and do what ever they like in terms of figuring out how to use macros and the like.

At the moment I have a space which I've created and set as private. So I, the administrator can only see and use but ideally every user could use and abuse this area.

Now it sounds all well and good adding this space and naming it test but I need to make it isolated from the rest of confluence. In that I don't want users to be linking to pages in the test space from in live spaces/pages by accident or on purpose.

Does anyone have any ideas?


Answers:
author: Bristow
body: You can't do it.


author: RianA
body: Hi, essentially if you make the view restriction of that space only to you, all the users won't be able to use it or even view it. It won't be even be available in the search result. Therefore there will be very less possibility for user to link to that space unless they have proper permission. If the other users that don't have permission saw that link, they won't be able to get into the space.

comments: author: Bristow
body: I fail to see what this has to do with my question as I've stated that I've made a closed test space for myself and I know that no one else can see or use it at the moment.

What I would like is more a long the lines of what Kay has said but without the need to have another instance of Confluence running. E.g. a single space that is isolated from the rest of confluence.


author: Kay Brown
body: We use a test instance of Confluence for that purpose.

Regards,

Kay

comments: author: Bristow
body: I know this is an option but for the amount it would be used compared to having whole other instance running isn't really beneficial for me.
Javadoc in Confluence
Asked by Bahar ?a?lar:

What does [developer.atlassian.com](http://developer.atlassian.com) use for adding javadocs in a confluence page?

There is an javadoc example in conluence:

<https://developer.atlassian.com/static/javadoc/upm/plugin-license-storage-lib/2.1/reference/com/atlassian/upm/license/storage/lib/ThirdPartyPluginLicenseStorageManager.html>

I have generated javadocs and I want to put them in a confluence page.

Thanks in advance.


Answers:
author: Stefan M
body: Try out the Docs Plugin. This seems to be that what you are looking for: <https://marketplace.atlassian.com/plugins/net.meixxi.confluence.docs.docs-plugin>


author: Matt Warren
body: There's also [](https://marketplace.atlassian.com/plugins/net.flosdorf.confluence.plugin.javadoc-macro)<https://marketplace.atlassian.com/plugins/net.flosdorf.confluence.plugin.javadoc-macro>


author: nriley
body: The javadoc is actually a static page (with the same header as the confluence pages we use) that includes the javadoc in an iframe I believe.

Currently it is not possible to embed a javadoc directly (by url) into a confluence page, however this should be possible in the upcoming 5.0 release of Confluence using the {html-include} macro. More information can be found here: <https://confluence.atlassian.com/display/DOC/Enabling+the+html-include+Macro>


Tags: javadoc
How to fetch part of blog post to page/blog post in Confluence?
Asked by Antti Mattila:

I would like to fetch part of the blog post e.g. text, table, panel etc. to another page or blog post. I have earlier used excerpt and excerpt-include macros to fetch information from page to page or from page to blog post, but when trying e.g. from blog post to page/blog post I just receive an error message stating: "The page \<name\> does not exist."

When setting the blog post as the source of information via excerpt include macro dialog / wizard, the wizard finds the blog post and I can select it. But still I get the same error message when I check the page via Preview tab or after saving the page =(

I have tried this with both Confluence v3.5 and v4.2.

I have tried to search a solution for but I have not found alternative way to solve this.

I'm also bit suprised why the excerpt macro functionality is supporting only normal pages as source of information in the first place, not also blog posts. I would be great if the support could be added!


Answers:
author: Denise Unterwurzacher [Atlassian]
body: This has been logged as an Improvement Request at <https://jira.atlassian.com/browse/CONF-27052>

The current workaround is to use the Blog Posts macro in conjuction with labels and the macro parameters, to display only the post/s you require.

At Atlassian we allow our customers to input into our bug fix and feature request prioritisation. We do this with the voting system - the more votes and detailed comments a ticket has, the more likely it is to be implemented. We use this as a way of gauging the needs of our customer base as a whole. I'd recommend voting on that ticket, and adding a comment detailing how it affects your system and what you would like to see. If you also add yourself as a watcher to the ticket, you'll be notified whenever it's updated.


author: Luzia Mendes
body: If you have tested it that much, it's probably a bug/feature request so it should go in [jira.atlassian.com](http://jira.atlassian.com) under confluence project.
metadata-calculate on calculated value
Asked by NielsJ:

I am trying to sum a summed value with the metadata-calculate macro and getting strange results. This is my setup:

**Page 1-1**   
Label: level_1  
Wiki: {metadata:mctest}5{metadata}  
Result: 5  

**Page 1-2**   
Label: level_1  
Wiki: {metadata:mctest}3{metadata}  
Result: 3  

**Page 2-1**   
Label: level_2  
Wiki: {metadata:mctest}{metadata-calculate:mctest\|label=level_1}{metadata}  
Result: 8 (=5+3)  

**Page 2-2**   
Label: level_2  
Wiki: {metadata:mctest}12{metadata}  
Result: 12  

**Page 3**   
Wiki: {metadata-calculate:mctest\|label=level_2}  
Result: 11 (I was expecting 20...)

Has anyone tried this before or can say why it isn't working?


Answers:
author: NielsJ
body: I debugged into the Metadata plugin and found that this is not possible. Internally the nested macro is not executed, so the String "{metadata-calculate:mctest\|label=level_1}" is converted to a number omitting all non-number, point and minus signs. So we get -1 for this value and 11 as result.


author: AlexeyM
body: And for any calculations you may use [CelesteCS Math for Confluence](https://marketplace.atlassian.com/plugins/com.celestecs.confluence.celestecs-math). Please contact me directly on any question on this plugin.

Thanks!
Confluence: email notifications about mentions by onDemand
Asked by Heinz Roth:

Hello,

when you mention someone with "@someone" on Confluence, this person is supposed to be notified via email. This works for me but not for some other colleagues which receive an email with the content below.

In the administration area, you can change some email settings in the JIRA section but not for Confluence. Is there anything I missed?

Thanks in advance, Heinz

-
> This is the mail system at host REPLACED.net.  
>
> I'm sorry to have to inform you that your message could not be delivered to  
> one or more recipients. It's attached below.  
>
> For further assistance, please send mail to postmaster.  
>
> If you do so, please include this problem report. You can delete your own  
> text from the attached returned message.  
>
> The mail system  
>
> \<someone@somecompany.com\>: host mail.somecompany.com\[1.2.3.4\] said: 553  
> 5.7.1  
> \<someoneelse@somecompany.com\>: Sender address rejected: not logged in (in reply  
> to  
> RCPT TO command)


Answers:
author: RianA
body: Hi Heinz,

Please bear in mind that OnDemand platform comes with internal SMTP configured as per the [Restricted Function](https://confluence.atlassian.com/display/AOD/Restricted+Functions+in+Atlassian+OnDemand). Perhaps the mail can't be reach at that time for those users, perhaps the email address was input wrongly or something wrong with the configuration of mail address of those users.

comments: author: Heinz Roth
body: The email addresses were correct and strangly this was only a problem when certain users used a @mention. It worked fine for me when mentioning the same users.

Anyway, without changing anything the problem hasn't occurred within a few days now and I guess it may be a problem of some sort with the email server communication.

Thanks for your suggestions!


author: JohnA
body: Hi Heinz,

From the problem you are describing it sounds like that the users experiencing this issuehave not configured their notifications correctly in their profiles, as described in this document: <https://confluence.atlassian.com/display/DOC/Subscribing+to+Email+Notifications+of+Updates+to+Confluence+Content>

All the best,  
John

comments: author: Heinz Roth
body: I tend to disagree.

The problem is not that notifications are not being sent because of misconfigured subscriptions. The problem is that an email configuration error results in an error email back to the editor of the page.

The part which talks about email configuration in the link you provided does not apply to Confluence OnDemand: "To enable Confluence to send email notifications, a System Administrator must configure an email server. See [Configuring a Server for Outgoing Mail](https://confluence.atlassian.com/display/DOC/Configuring+a+Server+for+Outgoing+Mail). *Not applicable to Confluence OnDemand."*

Thanks, Heinz


Tags: cloud

confluence-cloud
You are not permitted to perform this operation
Asked by Robin Rosenberg:

After installing confluence on my local server I am not able to use confluence.

Every page says You are not permitted to perform this operation. Apparently

authentication works as it does not yield errors on login.

I selected MySQL as the database and Jira for authenication.

The Jira admin account has been renamed.


Answers:
author: Robin Rosenberg
body: I had to add myself to confluence-users.


author: sheng song
body: Try to restart the confluence service.

comments: author: Vitaliy Vlasov
body: This helped me after tinkering with cwd_directory and cwd_app_dir_mapping tables did not seem to have any effect (following advice from <https://confluence.atlassian.com/display/DOC/Restoring+Passwords+To+Recover+Admin+User+Rights>)


author: Septa Cahyadiputra
body: Hi Robin,

Just a sanity check, could you please confirm that the JIRA admin account is a member of confluence-administrators on JIRA side. If not, please create "confluence-administrators" group on your JIRA side and add the JIRA admin into the newly created group.

From there, Confluence will pick up the changes in the next synchronization which will run hourly. To avoid such issue in the future, we highly recommend you to create a confluence internal administrative user which could be done by reviewing this [documentation](https://confluence.atlassian.com/display/DOC/Restoring+Passwords+To+Recover+Admin+User+Rights).

Hope it helps.

Cheers,  
Septa Cahyadiputra
"Sorry, a network error occurred" on server migration
Asked by Old Daniel Stieglitz:

I have recently re-deployed my Confluence server to a new host. We use Crowd for authentication, and I have verified that the crowd server URLs work from the command line (I can reach the servers, and if I try to access /crowd/services via TELNET I get a SOAP error).

I can't log in to my new instance, however. I get Sorry, a network error occurred trying to log you in. Please try again, and contact your administrator if the problem persists.

I looked through the log file, but there is no ERROR, or anything else that seems informative. In fact, nothing is appended to the log after Confluence startup (catalina.out)

How can I get more information about what's going on from the server?

<br />


Answers:
author: Septa Cahyadiputra
body: Hi Daniel,

Confluence logs is stored in atlassian-confluence.log which is located in \<Conf_HOME_Dir\>/logs/atlassian-confluence.log.

Judging from your issue description, it seems that Confluence new server is not able tor reach Crowd instance. Could you please double check if [the new Confluence server IP address is inputted into Confluence application remote address in Crowd?](https://confluence.atlassian.com/display/CROWD024/Specifying+an+Application%27s+Address+or+Hostname)

If the above does not help, I hope Confluence logs will give you a better information on this issue. We are looking forward to hearing from you.

Cheers,  
Septa Cahyadiputra


author: Old Daniel Stieglitz
body: The issue was indeed that Confluence was not able to reach Crowd. Compounding the problem was that Confluence was not using the crowd.properties files to get the server/login information, but was using settings stored in the database. To fix, it was necessary to restore the user directory to internal, reset the admin password, login, and update the settings through the web interface.


Tags: crowd

error

network
Form builder
Asked by alfredo parisi:

Hi, and compliments for your product, I'm testing it on localhost.  

I'm looking for a free form builder for Confluence.  

Someone can help me? Thank you


Answers:
author: JohnA
body: Hi Alfredo,

The only free plugin I can think of that supplies that functionality is the Form Mail NG plugin by Adaptavist: <https://marketplace.atlassian.com/plugins/com.adaptavist.confluence.formMailNG>

It seems that it is only compatible with 4.2.1 and lower, but this would be your best option assuming that you're not running the latest version of Confluence. However, you can also check the following list and get an idea of the commercial plugins available for creating forms in Confluence, but please ensure that you check the version compatibility to make sure the plugins you install/purchase are compatible with your version of Confluence: [https://marketplace.atlassian.com/search?application=confluence\&q=form](https://marketplace.atlassian.com/search?application=confluence&q=form)

All the best,  
John

comments: author: alfredo parisi
body: Hi John and thanks for your answer.  
I tested Form Mail NG on Confluence 4.3.1 and it doesn't work, it has a loop on the javascript as reported [here](http://www.adaptavist.com/display/community/infinite+loop+while+loading+List+Id+mail+-+on+Form+Mail+Management+page)
Problem importing confluence on-demand
Asked by Ahmer Javaid:

I am importing an export from another confluence on-demand

Importing xml export

See error in attached file

Your request can not be processed because a required security token was not present in the request. you may need to resubmit the form or reload the page


Answers:
author: Abdulrazaq Mohammed Ali Omar
body: Hi Ahmer,

May I know how you tried to import the file? I believe raising a ticket with us could be the best here so we can investigate further.

All the best.