How to import from guru cards to confluence pages

[Marlon Muela]

I have a list of guru cards that we have exported in csv format. I could not find a way to migrate cards from guru into space pages. There is a thread that redirects to this link: https://confluence.atlassian.com/confkb/how-to-import-a-third-party-knowledge-base-943523632.html. However, the link suggests to have it in separate text files for importing with XHTML format.

I checked confluence settings, but I could not find Content Tools > Import (asking for the text file from the directory) from this link: https://confluence.atlassian.com/doc/import-a-text-file-139492.html

The only option to import is from Word, Google Doc or OneDrive.

How can I migrate or import downloaded text files as pages in confluence?

[Elizabeth Barr · Accepted solution]

Welcome, @Marlon Muela. I happen to have experience with Guru (exporting content into it and exporting content out of it).

For context, @Nic Brough -Adaptavist-, Guru cards are their smallest unit of content. Like Confluence sites are made of spaces that have pages, Guru has collections (divided into boards made up of cards).

Unsurprisingly, their help center doesn't make it easy to find out how to remove Guru content and bring it somewhere else ;)

Using this method, you will get a zip with HTML and YAML versions of your content. I see that you're on Confluence Cloud, so the short answer from our help docs is: "If you have web content that you want to import into Confluence, you'll need to import it page by page." HTML= web content.

There may be other methods you can use to convert the HTML or YAML files from Guru to Word documents for easy import into Confluence, but none that I'm aware of off the top of my head. Let us know how it goes!

[Nic Brough -Adaptavist-]

Thanks for helping out!

[Fabio Germann]

@Marlon MuelaI had the same issue and created an importer.

Once you exported the collection as ZIP file and download/extract it you can use:
https://github.com/fabiogermann/guru-confluence-importer

Thanks @Elizabeth Barr for the hint with the ZIP file - it inspired me to write the importer.

[Elizabeth Barr]

AWESOME, @Fabio Germann !!!!

[Nic Brough -Adaptavist-]

Welcome to the Atlassian Community!

Confluence is a wiki, a documentation system, it's not for handling lists of things like CSV, spreadsheet, issue trackers etc are.

It's expecting imports of text (often with some level of formatting).  You could "import" a CSV file as text, but all that will do is give you a page with a block of CSV as the content.

What data are your "guru cards" representing?  (Forgive me, I've not worked with that before and I don't know). 

If it is exportable as CSV, it suggests it's likely to be issues (especially as it uses the word "card" which is a common way to describe issues in certain views in issue trackers), which I'd be looking to import into Jira. 

But if it really is a knowledge base, then I'd expect an export to drop each article out as a separate file, or in an XML format that includes all the metadata.  If it is something like one line of CSV per article, then you would need to convert that into a more knowledge-base style structure - exporting each line as a single text file is the obvious one that Confluence could then import as separate pages.