youngmon/atlassian-qna huggingface dataset:
How do you manage documentation in several languages?
Asked by Identity:

Hello.

More of a documentation structure/organization question.

What should be the best way to manage documentation in several languages?

I have a few modules, bundled in a few topics, and I would like to provide the same document in several languages. Do I simple create multi-language versions of the same modules and create different topics?

Thanks for any insight. Regards.


Answers:
author: Elizabeth
body: [Enterprise Translations Hub for Atlassian Confluence](https://www.appfusions.com/display/LNGOTKC/Home) was built for exactly the use case you describe. One base language, and translate **all from within Confluence** into multiple different languages.. Features include:

* Confluence documentation translated on demand (automated)
* Search returns results in language searched for, not all languages
* Per language table of contents, and corresponding documents - per space
* Rapid translations in a secure environment (enterprise-grade)
* Real-time translation status and progress reports
* In-Confluence "post-editing" panel to correct translations following run (i.e., tune the translation engine)
* Post-edits saved back to Translation memory, allowing for accuracy growth
* Version support between iterations of the documentation
* Translated vocabulary tailored to your context
* 100+ languages supported
* in-app Machine Translator (MT) engine support, including:
  * AppTek Omnifluent
  * Asia Online
  * Google Translate, Enterprise version
  * Language Weaver
  * Microsoft Translator, Enterprise edition
  * Microsoft Translator Hub (for Enterprise)
  * SDL BeGlobal
  * *And any other MT engine that has an API*

<https://www.youtube.com/watch?v=dVrTwdMAJxE>


author: Davin Studer
body: There are a couple of plugins in the marketplace specfically for multi-language support.

<https://marketplace.atlassian.com/plugins/ch.bitvoodoo.confluence.plugins.language>

<https://marketplace.atlassian.com/plugins/com.k15t.scroll.scroll-translations>

comments: author: Kilian Bazin
body: Hi Davin, thank you for this answer, any idea of the release date of the cloud version ?

All the best,


author: Davin Studer
body: I do not work for either company so I do not have any idea if they are planning a cloud version of their add-ons.
pdf render
Asked by Roman Volf:


Answers:
author: Elizabeth
body: [SharpView High-Resolution PDF Viewer for Atlassian Confluence](https://www.appfusions.com/display/SHRPVW/Home) is exactly the purpose of the two-word question. Supports HTML5 and multiple OS, devices, browsers, etc. all from Confluence.

Click the link above for an example that is in-page, or here is a video.

<http://youtube.com/watch?v=be2M_GUPBFk>


author: Mallmann
body: Hey Roman,

I'm not sure what your question is, since you did not describe it. However, you might want to take a look at the following links:

PDF Macro: <https://confluence.atlassian.com/display/DOC/PDF+Macro>

PDF export customisation: <https://confluence.atlassian.com/display/DOC/Customising+Exports+to+PDF>

Troubleshooting PDF issues: <https://confluence.atlassian.com/display/CONFKB/PDF+Issues+Troubleshooting>

I hope it helps! :smile:

Eduardo


author: Norbert Janssens
body: You do not give us too many informations about your problem!
Exporting templates
Asked by Ruwan Mettananda:

Is there a way to export a template to another space?


Answers:
author: teo
body: Plugin to copy templates. Export and import templates.  
Copy 'variables, macros, and other elements. It is not possible to copy-paste.  
<https://marketplace.atlassian.com/plugins/com.deiser.confluence.template-ops>


author: Nic Brough -Adaptavist-
body: Not via a button, but it is possible to edit template-1 copy the whole edit box, and paste it into a new template in another space
How do I change the status of a discussion?
Asked by Matt Goldsberry:

From IN DISCUSS to CLOSED or whatever.


Answers:
author: Luiz Maia
body: Hi Matt,

When a discussion is opened, it will show the "In discuss" status. From "In discuss", it can change to "Resolved" by marking some comment as "Useful reply". Only the owner of the discussion can perform it.

Thank you!

Kind Regards,  
Luiz Maia
Moving attachments in Confluence
Asked by Neil Taylor:

We recently made the change from Confluence v3.5.x to v5.6.x -- In 3.5, we were able to move attachments from one page to another without having "delete attachment" permissions. This was extremely useful for letting users be able to move attachments without administrators stepping in to help.

<https://confluence.atlassian.com/display/CONF35/Moving+an+Attachment>

Is there any way around this? I have checked through any space/global/etc permissions I can find to allow users to do this, but it seems to not be easily possible. I would prefer to not let the users be able to delete attachments completely.


Answers:
author: Guilherme Nedel [Atlassian]
body: Hello Neil, the feature is still there, under *Attachments* section, into the *properties* link. There are images for reference just below. :smile:

attachment1.jpg

attachment2.jpg

[](https://community.atlassian.com/t5/Confluence-questions/Moving-attachments-in-Confluence/qaq-p/202872?attachment-id=5242){#link_1188a4c619aeb0}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/34115/1/attachment2.jpg){#display_1188a4c619aeb0_0}  
[](https://community.atlassian.com/t5/Confluence-questions/Moving-attachments-in-Confluence/qaq-p/202872?attachment-id=5243){#link_1188a4c619aeb0_0}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/34115/2/attachment1.jpg){#display_1188a4c619aeb0_2}


Tags: attachment

confluence-administration
How do i change my space theme back to documentation when the selection box is missing?
Asked by chad little:


Answers:
author: Paula Silveira
body: Hi Chad,

Try the following:

* Open the space
* Click on the cog icon (on the left bottom)
* Click on Look and feel
* Go to Theme section, there you should be able to update it

Thanks and regards,  
Paula Silveira


Tags: cloud

confluence-cloud
Do I need an SMTP Relay when setting up an Outgoing Mail Server for Confluence?
Asked by George Baier IV:

We're using Exchange to setup a mail account for Confluence. Does this need to be an SMTP Relay? I can't find specific mention of this in the [Confluence Server documentation](https://confluence.atlassian.com/display/DOC/Configuring+a+Server+for+Outgoing+Mail).

I'm also wondering how people are getting around an expiring password.


Answers:
author: no_longer_in_sudoers_file
body: @George Baier IV,

I've been where you're at and would recommend against an SMTP Relay. Instead, configure your Confluence server to smarthost the email through Exchange:

1. Create a service user account on Exchange (This is just a normal mail user dedicated to the confluence system).
2. Configure Confluence to use the servername, username and password just like you would do for any Mail client (e.g. Outlook).
3. Test and verify the emails relay just fine.

SMTP relays can be abused in so many ways I always recommend against them. Having an authenticated smarthost, allows Confluence to send as an auditable user which you can track on the Confluence and the Exchange side for troubleshooting.

--Sam

comments: author: George Baier IV
body: We ended up using SMTP.com because Confluence is hosted on an outside server. Our company policy is to not let outside servers use our Exchange server directly. So SMTP.com worked out perfectly for this.


author: Boris Berenberg
body: Your Exchange server must be configured to accept SMTP connections. I am not sure if that means a "relay" in exchange terms, but it is not a relay in SMTP terms.

When you say expiring password, I assume you mean for the email account sending the email? I would disable an expiring password on this account and set it to only be allowed to login from the IP of your Confluence server.


Tags: confluence-administration

ms-exchange
HipChat Integration Failure
Asked by Kevin Eggleston:

Confluence is running on our Intranet with version 5.6.6. I successfully installed the HipChat add-on plus signed up and created a group on the HipChat site. When I try to preform the integration from our Confluence server I get the error.

Unable to install integration

The value must be an absolute URL

As a test I also setup the add-on with our JIRA instance and tried to integrate it and received the same error as well. I'm wondering if it is because our Confluence/JIRA instances are only internally accessible and have no external access?


Answers:
author: Rodrigo Girardi Adami
body: Hi Kevin,

Daniel is correct. If you are using the Atlassian Hipchat and not your own Hipchat server, then you must have access to the outside.

[When setting up the proxy](https://confluence.atlassian.com/display/DOC/Using+Apache+with+mod_proxy), also make sure that you put the proxy host name and proxy port to allow the correct communication between Confluence/JIRA and the outside.

Cheers,

Rodrigo


author: Daniel Wester
body: The JIRA \& Confluence servers will need to be able to make outbound requests to api.hipchat.com. If your networking rules don't allow that - that would explain the errors.


Tags: confluence-administration
Is there a way to copy a table from on page to another?
Asked by Cynthia Schirmer:

Is there a way to easily copy a table from on page to another?


Answers:
author: Davin Studer
body: Do you want the tables to stay in sync with each other? If so, then check out the excerpt and include excerpt macros. If not then copy and paste works.

comments: author: Barbara Reichart
body: <https://docs.stiltsoft.com/display/public/TableFilter/How+to+use+Table+Excerpt+and+Table+Excerpt+Include+macros>


author: Paula Silveira
body: Hi Cynthia,

The normal copy and paste shortcuts work, like **command** + **c** . Please refer to [Working with Tables](https://confluence.atlassian.com/display/DOC/Working+with+Tables) for further information.

Thanks and regards,  
Paula Silveira

comments: author: RomanKitainik
body: Ctrl+C does not work and the page you link to does not exist.

The only way that works so far is to add dummy text above and below the table, copy the text *and* the table, paste, then remove the dummy text from around the pasted table.


author: John M
body: [@RomanKitainik](/t5/user/viewprofilepage/user-id/292896) this works so well!


author: Daniel De Juan
body: I've found that it's much easier to select the table for copying when the source page is in published or preview mode than when it is in edit mode. In edit mode, it behaves really strangely when you drag the mouse over it (not highlighting the selection, etc.). Hope this helps!


Tags: cloud

confluence-cloud
How to remove LDAP repository
Asked by Sergei Dorogin:

I added an LDAP and switch the order of user repositories. My bad I know.

But now I can't login as local admin into my Confluence as my LDAP contains a user 'admin'.

What can I do?


Answers:
author: Suren Raj
body: Hi Sergei,  

This should do the trick and have at least you login with your local admin account. You need to move Internal directory into the first position:

* [Step 3. Put the Internal Directory in First Position](https://confluence.atlassian.com/display/CONF54/Restoring+Passwords+To+Recover+Admin+User+Rights#RestoringPasswordsToRecoverAdminUserRights-Step3.PuttheInternalDirectoryinFirstPosition).

:warning: Before running any SQL query, please do a full backup of your database, in case things goes sideways.  

Cheers  
Suren

comments: author: Sergei Dorogin
body: Thanks.But it looks like "Put the Internal Directory in First Position" assumes that I use External SQL DB but I don't. I'm on Embedded DB. How to restore the order in that case?


author: Suren Raj
body: Hi Sergei,I suggest you to install DB Visualizer and connect it with your embedded database. I suggest you to read below Documentation on how to connect Confluence embedded database with Db Visualizer.\* <https://confluence.atlassian.com/display/DOC/Connecting+to+HSQLDB+using+DBVisualizer+or+HSQL+database+manager>


author: Suren Raj
body: After you connect the database and db visualizer, run the query in db visualizer


author: Sergei Dorogin
body: Thanks!I found INSERTs in confluencedb.log and swaped indeces in them:INSERT INTO CWD_APP_DIR_MAPPING VALUES(131073,65537,98305,'T',0)INSERT INTO CWD_APP_DIR_MAPPING VALUES(131074,65537,98306,'T',1)and it works now!


Tags: confluence-administration
We are planning to upgrade Confluence from 5.1.3 to 5.7 version. are there any issues or is recommended to upgrade Confluence directly from 5.1.3 to 5.7.
Asked by srinivasa_pudi:

We are planning to upgrade Confluence from 5.1.3 to 5.7 version. are there any issues or is recommended to upgrade Confluence directly from 5.1.3 to 5.7.

Please let us know.


Answers:
author: Davin Studer
body: Do you have anyone using IE8? If so then it will break for them when you go up to 5.7. IE8 stopped being supported in 5.6.


author: Mallmann
body: Hey Pudi,

Also remember to check the plugin compatibility using our bundled tool: <https://confluence.atlassian.com/display/UPM/Checking+Add-on+Compatibility+with+Application+Updates>

It's good to verify whether all plugins you're currently using are supported on the targeted Confluence version before upgrading :smile:

I hope it helps

Eduardo


author: Suren Raj
body: Hi Pudi,  

I would suggest you to upgrade your Confluence manually and you can directly upgrade to Confluence 5.7.   
Before you upgrade please backup :

1. Your External Database.
2. Your Confluence Home Directory.
3. The Confluence installation directory

You can get more info regarding Upgrading in the below Documentation:

* [Upgrading to 5.7](https://confluence.atlassian.com/display/CONF57/Upgrading+Confluence)

Cheers  
Suren[](https://confluence.atlassian.com/display/CONF57/Upgrading+Confluence)

comments: author: Nic Brough -Adaptavist-
body: It's also a good idea to read the release notes for each minor release in between - 5.2, 5.3, 5.4 etc. Just in case there's something in one of them that may break something on your setup. (Unlikely, but it can happen)
user mention
Asked by DeloitteEA:


Answers:
author: Mallmann
body: Hey Daniel,

Can you please describe what questions you've got regarding the user mention feature?

Eduardo


author: Paula Silveira
body: Hi Daniel,

Please refer to [Using Mentions](https://confluence.atlassian.com/display/DOC/Using+Mentions) for information of how mentions work on Confluence.  
If the mention feature is not working correctly, please try doing a [Content Indexing](https://confluence.atlassian.com/display/DOC/Content+Index+Administration).

Thanks and regards,  
Paula Silveira
How to update Confluence Application Links via database?
Asked by John Yeuk Hon Wong:

Hi I have not found any tutorial that shows me how to update the app link in Confluence via database.

<https://confluence.atlassian.com/display/JIRAKB/How+to+update+the+url+for+Application+link> only shows the version with JIRA which I am able to do so.

```
UPDATE propertystring SET propertyvalue='https://confluence-staging.example.com' WHERE id in (SELECT PS.id FROM propertystring AS PS INNER JOIN propertyentry AS PE ON PS.id = PE.id WHERE PE.property_key LIKE '%app%' AND PS.propertyvalue LIKE '%confluence.%');
```

How do I do that with Confluence? I see trustedapp table but I have just one row!

```
confluence=# select * from trustedapp; trustedappid |     name     | timeout | public_key_id--------------+--------------+---------+---------------     44597254 | jira:9972319 |   10000 |      44630022(1 row)
```

Is that normal!? Thanks


Answers:
author: John Yeuk Hon Wong
body: Okay I finally found it.

```
UPDATE bandana SET bandanavalue='&lt;string&gt;https://jira-staging.example.com&lt;/string&gt;' WHERE bandanaid in (SELECT bandanaid FROM bandana  WHERE bandanakey LIKE '%applink%' AND bandanavalue LIKE '%jira.example.com%')
```


Tags: application-link

confluence-administration
Code Macro Administration in confluence
Asked by John Dos Santos:

Please help me adding YAML syntax to confluence.

We want to add YAML syntax highlighting to Confluence. referring you the link.

<https://github.com/gibwar/ConfluenceWikiMarkup/blob/master/Confluence%20Wiki.YAML-tmLanguage>

for this i am using "Code Macro Administration" in confluence and adding new language. can u please tell me how can i apply with yaml language..

Error: which i am facing is :   
The following error(s) occurred:  
The uploaded language file is not a valid language definition. Consult the application log for further information.

what is the steps and how to i upload file ? confluence version is 5.5

Thanks  
Soni Pandey

soni.pandey@operasolutions.com

<br />


Answers:
author: Joe Clark
body: Hi,

That file you are using does not look like it will work. You need to upload a language file that is compatible with the SyntaxHighlighter open source library (<http://alexgorbatchev.com/SyntaxHighlighter/>).

See my other answer here for more information: <https://answers.atlassian.com/questions/13417525>

Try uploading a file like this instead: <https://gist.github.com/Nijikokun/1131094>

Kind regards,

Joe.
Why does the Roadmap Macro plugin embed a list of all my spaces?
Asked by David Yu:

Ok, maybe not all the spaces, but it's still quite a long list. This doesn't seem very efficient. We have a lot of spaces.

Selection_443.png  
[](https://community.atlassian.com/t5/Confluence-questions/Why-does-the-Roadmap-Macro-plugin-embed-a-list-of-all-my-spaces/qaq-p/124854?attachment-id=11329){#link_1188a5bef17d95}  
[](/tnckb94959/attachments/tnckb94959/confluence-questions/20805/1/Selection_443.png){#display_1188a5bef17d95_0}


Answers:
author: Giuliano C.
body: Hi David,

As the Roadmap macro add-on works according to the timeline for planning projects in the instance, it's used based on the **currentspaces** parameters. However, according to this [open request](https://jira.atlassian.com/browse/CONF-36732) that are related to developers ones, we are working to have it removed in the next releases of Confluence regarding possible security issues (such as to display the space keys for restricted ones, which should not be available.

Let us know if you need a bit specific help on the clarification for this one, sir.

Regards,

Giuliano Tenedini


Tags: confluence-administration
Display a Working Table of Contents on a Different Page
Asked by MarkC:

I have the following scenario, and if anyone has a better suggestion, I'm all ears!

I want to be able to pull in a table of contents of the headings on various pages onto a single page. I can make this work using an Excerpt macro on the TOC and then pulling in the TOC on another page with the Excerpt Include macro. However, the TOC doesn't work as the links point to the current page.

Essentially I need links to all the headings dynamically created for a different page to display on another page. Is there a way to do this?

We're using Confluence 5.5.2, if that matters.


Answers:
author: MarkC
body: Got it!

In the Table of Contents macro, you have to select the Absolute URL check box. Then you can the TOC inside an Excerpt, pull that Excerpt to another page, and the URLs will function correctly.


author: Jay Smith
body: This does not work with Scaffolding/Live Templates. Confirmed in <https://ideas.atlassian.servicerocket.com/ideas/SCAF-I-177>


author: Manohar Dondlapally
body: I got it working. Thanks.

But when I export it to PDF, the hyperlinks are not pointing to the actual PDF sections rather redirecting to the Actual URLs. Any help to correct this is really appreciated.I tried using excerpts and Page includes but the Chapter numbering is starting with the page titles and all the section numbering got messed up. Any help is really really really appreciated.


author: jainil trivedi
body: Thanks for the answer, it was very useful


Tags: confluence-administration

excerpt

table-of-contents
Can we Copy website hosted in IIS to Confluence?
Asked by Raja Shekher Kammara:

We have a requirement, where we have 400+ websites hosted on IIS. How can we quickly convert Websites into Spaces and then those Webpages into Confluence Pages on Internal Hosted Confluence Version as well as on Cloud Hosted Version.

Any help would be highly appreciated,

Thank you.


Answers:
author: Alex Yasurek
body: Hi,

The only way I can think of is to create some app that takes the content of each page of your website, everything between the body tags only, and adds it to Confluence using their API. We are currently working on something similar. We have a bunch of content on google sites that we need to move over and this is the route we are taking. We created an app using Google App Scripts that will take the content of each web page and using Confluence's JSON-RPC api, we import them into Confluence one by one. It works well except for images. It will display them but the images still live on our server. We have to manually move them over at some point and re-link them. We can probably also come up with a script for this but don't have the time now.

This can be done in any programming language you want and is easier than the alternative of copy and pasting the content of each page manually into confluence.

SOAP or RPC api:

<https://developer.atlassian.com/confdev/confluence-rest-api/confluence-xml-rpc-and-soap-apis>

Or they also have a REST api:

<https://developer.atlassian.com/confdev/confluence-rest-api>


author: rrudnicki
body: Hi Raja,

We have [this documentation](https://migrations.atlassian.net/wiki/display/UWC/Universal+Wiki+Converter) which explains how to import other wikis into Confluence.

IIS isn't an issue, since Confluence can run with that. Can you let us know what are you running your sites? I mean, it's on wordpress or another kind?

Regards,

Renato Rudnicki


author: Deividi Luvison
body: He Raja,

As far as I'm aware there is not a ready to go solution to simply convert any kind of website to Confluence ![sad](/html/@C495B4504065515364EB1894F812B34C/images/emoticons/sad.png "sad"). For this task specifically I would advice you to reach [Atlassian Experts](https://www.atlassian.com/resources/experts) for a quote free of charge.  

If you get your hosted sites turned into spaces in your internal Confluence then you would need to do a space by space export to impot into Confluence Cloud (Make sure to Have your internal Confluence on the latest version):  

<https://confluence.atlassian.com/display/Cloud/Importing+a+Confluence+Space>  
Hope it helps.  
Thanks and Regards,  
David\| The Engineer that like Windows for realsies.


Tags: confluence-administration
group team members calendar event into one team manager calendar
Asked by Alberto Todeschini:

Hi all,

I want to create personal calendar for each member of the team (e.g. insert vacation days) with restricted access only to calendar owner, and the team manager can have a calendar with visibility of all team members events of this calendars.

How do I achieve that? Is it possible?

Thanks


Answers:
author: rrudnicki
body: Hi Alberto,

Did you have a look into [this documentation](https://confluence.atlassian.com/display/TEAMCAL/Restrict+a+Calendar)? I believe it will be useful.

Regards,

Renato Rudnicki

comments: author: Alberto Todeschini
body: Hi Renato,

thanks for reply...This doc achieve the first part of the "project".

The "strong" part is realize a calendar that group all the events of the members'calendar into one...


Tags: event

team-calendars-for-confluence
show jira field
Asked by NovarumDX Admin:


Answers:
author: Suren Raj
body: Hi Ian,  

Are you planning to show JIRA issue in Confluence? If yes, you need to do the following:

1. [Create application link between Confluence and Jira](https://confluence.atlassian.com/display/DOC/Linking+to+Another+Application)
2. [Add JIRA issue macro in Confluence](https://confluence.atlassian.com/display/DOC/JIRA+Issues+Macro)

You also can read the following page to understand more about displaying JIRA issue in Confluence:  
<http://blogs.atlassian.com/2013/07/display-jira-issues-in-confluence-more-power-more-control/>  

<br />

Cheers  
Suren