MadCap Software Forums

I'm afraid I haven't found a good solution yet.

This is a long standing bug which unfortunately has yet to be fixed. This is a problem for those of us who create documentation for programming example with e.g. long URL links or long lists of numbers / characters without a space e.g. for API keys, etc. Not splitting the text seems to take priority ...

Hi, sorry slow reply. It's working fine but lacks workflow features. I would like the ability to mark comments as completed or fixed and filter the view to see all complete / incomplete comments. In conclusion, better than anything else we found but I still don't think it's the ideal solution. Still ...

Thanks Dave I'll try that.

Hi Dave, Thanks for your reply earlier. Can I get the advantages of conditional text with global project linking? Will this allow me to link to two different versions of the same topic (the output after conditions are included / excluded)
Thanks
Ian

Hi Devjoe, thanks for your suggestion. I can see this would work but it does seem very fragile i.e. all links of this type will break if I move or rename the target file. Whereas this is not the case for normal Flare links. Why is Flare unable to calculate the path for these links?

Is it possible to link to a version of a topic created using conditional text? I have two Sub Targets which I include in my Master TOC: 1 for Android and 1 for iOS. these topics share a lot of content e.g. they have the same file overview.htm which is included in both the Android version and the iOS ...

We are currently using https://hypothes.is/ this seems OK but still interested in any other solutions that might be out there

Hi, can anyone recommend a web based reviewing / commenting system? I am looking for something which will allow subject matter experts to comment on the deployed stage version of our webhelp i.e. live on the web but only accessible with a username and password. We are looking for web equivalent of ...

Got the following from Flare support which solved the problem Please navigate to the following file, as the Network Settings of a HTTP Proxy are stored in a localized ".GIT" file that is written to the machine when bound. C:\Users\[username] On this directory locate a ".gitconfig" file and right ...

Hi Robnyc thanks for the details about Salesforce

My project is currently bound to GIT. I have been able to successfully push and pull changes to the remote Github repository. Unfortunately, my colleague who works in another office with stringent firewall settings has not been able to push changes. In order to resolve this problem we tried to set a ...

Hi, I am also looking at something similar but do not have PHP experience so may not be able to use RamonS's suggestion. Anyone else implemented search in this way?
Elasticsearch or Solr seem options. 3lliot what did you go with in the end?

Hi everyone, I wonder if anyone has experience with integrating Flare with a CMS such as Django CMS or Typo3 and can provide advice? We are looking to import our Flare output html pages into a CMS to give us an integrated search for our site and to ensure consistent styling across the site. We will ...

Hi Ramon,
Interesting idea; I hadn't considered that possibility. Would it not be more work though to create their own parser (re-creating conditional text, variable, etc.) rather than post-processing Flare's build system's output?
Ian

Hi Dave, They are in the Flare customer showcase (about halfway down). http://www.madcapsoftware.com/products/flare/customer-showcase.aspx I see what you mean though; I wonder if they process the output from Flare and import into another system. Thanks for the suggestion and useful links. Much ...

Hi, does anyone know how Salesforce created their developer centre? https://developer.salesforce.com/docs/atlas.en-us.ajax.meta/ajax/sforce_api_ajax_connecting.htm I understand they use Flare. Is the Flare output imported into a CMS? I notice there is a waiting icon when changing topics. Is this the ...

Hi, I've been asked to recommend a tool to create developer documentation (getting started guides for programmers) with lots of code samples. The model is https://stripe.com/docs or https://www.algolia.com/doc/ruby#using-the-api i.e. frameless with side navigation. Note this is not for API reference ...

Thanks for the links Lisa, apologies for the delay in replying.

Thanks Ramon, that's a much narrower definition than I had in mind and possibly narrower than my boss had in mind as well. Good to know.
Cheers
Ian

Hi, I've been asked to look into creating a Knowledgebase for our product. Unfortunately Knowledgebase seems a very ill defined term. Am I correct in thinking it's basically Webhelp (HMTL or HTML5) with a comment feature? Is there anything else that I am missing, can anyone give a list features that ...

Hi Angela, apologies for the slow reply. That sounds a good setup. I'll check out the other git tools at the link you provided.
Thanks
Ian

I've managed to get a working solution although it's a bit of effort. It might not be worth it for small code blocks Generate an svg file from the source code using the gui version of the highlight tool downloaded from http://www.andre-simon.de/doku/highlight/en/highlight.php. Set the highlight tool ...

Does anyone have a automatic or semi automatic method for highlighting source code (XML, scripts, java code) for pdf output. I know this is easy to do for HTML output using javascript. I found the following tool http://www.andre-simon.de/doku/highlight/en/highlight.php which can produce highlighted ...

Hi Jason, just following up on this thread. Please submit a feature request for cross references to support link text. See http://forums.madcapsoftware.com/viewtopic.php?f=13&t=9533 for another thread on this topic. Personally I think Madcap should add all the missing features of hyperlinks to cross ...