Search found 342 matches

by devjoe
Fri Apr 27, 2018 7:52 am
Forum: Flare's General Discussion
Topic: Is it Possible to Use Flare to Single Source Websites?
Replies: 4
Views: 1581

Re: Is it Possible to Use Flare to Single Source Websites?

The web-based outputs are designed to be used on a web site, and the publishing feature of Flare lets you automatically copy the output to a designated location, such as an FTP or file share folder on the web server.
See http://help.madcapsoftware.com/flare2017r3/Content/Flare/Output/About-Building ...
by devjoe
Fri Apr 27, 2018 5:40 am
Forum: Flare's General Discussion
Topic: Is it Possible to Use Flare to Single Source Websites?
Replies: 4
Views: 1581

Re: Is it Possible to Use Flare to Single Source Websites?

You can do this in Flare using variables for things like product names, and snippets for longer bits of text which include tags. You create the variables and/or snippets in your project, and replace the occurrences of that thing with references to the variable/snippet. Then when you want to change ...
by devjoe
Thu Apr 26, 2018 11:56 am
Forum: Printed Documentation Targets
Topic: Hyperlinks/Cross-references
Replies: 2
Views: 1351

Re: Hyperlinks/Cross-references

Define a "screen only" conditional tag and exclude it from the PDF targets. Apply this to the links. Depending on how the links are written, you may be able to apply it directly on the A tags and tell Flare to unbind the tags when the condition is excluded (so the text will still appear in the PDF ...
by devjoe
Wed Apr 18, 2018 5:26 am
Forum: Flare's General Discussion
Topic: Build failed: Could not find file '.../Output/..blaa'
Replies: 3
Views: 2017

Re: Build failed: Could not find file '.../Output/..blaa'

It sounds like you have linked something in your project to something in the output folder.
Try to find and fix this reference. Use Find and Replace in Files, Find /Output/, All file types, Find in source code.
You might also try running Analyzer on the project, with the output cleaned, to see if ...
by devjoe
Wed Apr 18, 2018 5:18 am
Forum: Flare's General Discussion
Topic: PDF: H4s being rendered the same as H1
Replies: 3
Views: 1583

Re: PDF: H4s being rendered the same as H1

This is what "TOC Depth for Heading Levels" means. The levels of the headings at the start of each topic are adjusted to match the indentation levels of their TOC entries. These headings adopt the styling of the heading styles they become.
by devjoe
Tue Apr 10, 2018 12:10 pm
Forum: Printed Documentation Targets
Topic: PDF output organized as parts with chapters
Replies: 3
Views: 1578

Re: PDF output organized as parts with chapters

It sounds like you have the option enabled (on the Advanced tab of the target) to use the TOC depth for heading levels. If you turn that off, it will leave the headings set however they are in each topic.
by devjoe
Thu Apr 05, 2018 2:00 pm
Forum: Tips and Tricks
Topic: Varaibles in Hyperlinks
Replies: 13
Views: 20961

Re: Varaibles in Hyperlinks

In recent versions, this format used to be documented in the Flare help, but it seems it's fallen out in 2017r3 help.
The formats still work. When you are using a variable someplace other than in literal text elements of a page:
If the variable makes up the entire text of its entry (for instance ...
by devjoe
Wed Apr 04, 2018 11:49 am
Forum: Single-Sourcing
Topic: Best practice single source
Replies: 12
Views: 8639

Re: Best practice single source

The one thing you'll get yourself into is if you add core functionality that requires new topics in shared material that spans across all products, you'll have to edit all the TOCs to include the new topic. Given your other concerns, and especially if this is considered unlikely, then you may accept ...
by devjoe
Tue Apr 03, 2018 11:43 am
Forum: Styles, Stylesheets and XML
Topic: After years of working with Flare, I should know this. But..
Replies: 3
Views: 2031

Re: After years of working with Flare, I should know this. B

Flare topics are XHTML files, which are written in a strict subset of HTML which makes them also valid XML files.
This means that capitalization of opening and closing tags must match, all elements must be closed (even ones like <img> and <br> which aren't containers; these usually use the self ...
by devjoe
Tue Mar 27, 2018 10:18 am
Forum: Web-based Outputs
Topic: HTML5 "Nu Validator"
Replies: 7
Views: 4032

Re: HTML5 "Nu Validator"

The “cellspacing” attribute on the “table” element is obsolete. Use CSS instead.

This indicates that you have inline formatting on the table. This often happens with imported or pasted material ultimately originating from a Word document or email. Unless you are really doing something special for ...
by devjoe
Thu Mar 22, 2018 7:10 am
Forum: DotNet Help and the Dot Net Viewer
Topic: Printing nested TOC
Replies: 4
Views: 28200

Re: Printing nested TOC

henkjans wrote:I thought that somehow common use of a TOC is to right click a chapter and to choose print only the topic or all underlying topics as well.
The CHM help viewer has this feature, but no other help system I have seen offers this.
by devjoe
Thu Mar 15, 2018 7:08 am
Forum: Single-Sourcing
Topic: Snippets vs Variables - Best Practices?
Replies: 13
Views: 8819

Re: Snippets vs Variables - Best Practices?

So would you use variables, for example, for URLs?
I regularly put URLs and email links in individual snippets. If I were to make them variables, they wouldn't have any "links" behind them.

What I am talking about is when you have a link that needs to have a different destination in different ...
by devjoe
Thu Mar 15, 2018 6:52 am
Forum: Flare's General Discussion
Topic: Converting Equations
Replies: 4
Views: 2198

Re: Converting Equations

Maybe something is broken in your installation?
It looks a little different, but it's still available for me, on Microsoft Word 2016 MSO (16.0.8431.2110).
They've made it harder to find the version info than it used to be. It's now at File | Account | About Word.
Which version are you on?
by devjoe
Wed Mar 14, 2018 7:01 am
Forum: Flare's General Discussion
Topic: Converting Equations
Replies: 4
Views: 2198

Re: Converting Equations

If you are using the modern equation system from Word 2007 and beyond (rather than the old external Equation Editor app), you can copy a Word equation as MathML. But to do so, you have to set an obscure Word option.
Click in the equation. The Equation Design ribbon tab appears.
Click the tiny ...
by devjoe
Fri Mar 09, 2018 11:03 am
Forum: Single-Sourcing
Topic: Snippets vs Variables - Best Practices?
Replies: 13
Views: 8819

Re: Snippets vs Variables - Best Practices?

Use a variable when you are specifying a short bit of unformatted text such as the name of a product, product feature, or company.
Use a variable when you are specifying text that might get included within a TOC entry, the destination of a link, or any similar place other than displayed topic text ...
by devjoe
Mon Mar 05, 2018 2:15 pm
Forum: Flare's General Discussion
Topic: If topic >1 in TOC, how do I create xref to instance?
Replies: 2
Views: 1095

Re: If topic >1 in TOC, how do I create xref to instance?

We solved this problem of the TOC sync with multiple instances of a TOC entry by using bookmarks. Each instance in the TOC gets a unique bookmark and all links point to the bookmark appropriate to their section of the help. Stuff all the bookmarks at the beginning of the topic (so they don't open ...
by devjoe
Thu Mar 01, 2018 1:30 pm
Forum: Styles, Stylesheets and XML
Topic: Keep different medium styles in same stylesheet or separate?
Replies: 15
Views: 9923

Re: Keep different medium styles in same stylesheet or separ

If your users' workflow includes printing topics from the HTML output, then putting the mediums in the same stylesheet will allow the browser to format the page using the print medium when the user prints the topic.
However, it's more work in some cases specifying the print medium to override little ...
by devjoe
Tue Feb 27, 2018 1:48 pm
Forum: Web-based Outputs
Topic: 1 Project/5 docs - Repeating Content in Each
Replies: 4
Views: 2098

Re: 1 Project/5 docs - Repeating Content in Each

OK, then, two things to do:

Where you have links that go between different targets, instead of just inserting the link in the simple way, add the link as an external document and type enough ../ to go up to the common folder above doc1 & doc2, and then the path down into the destination in doc2 ...
by devjoe
Fri Feb 23, 2018 3:02 pm
Forum: Web-based Outputs
Topic: 1 Project/5 docs - Repeating Content in Each
Replies: 4
Views: 2098

Re: 1 Project/5 docs - Repeating Content in Each

So you made a separate TOC for each doc and associated it with each target?

In the targets, there is an option to only include files linked directly or indirectly from the target. If you check this, it will only include in each output the files needed for that output.
by devjoe
Fri Feb 09, 2018 8:04 am
Forum: Tips and Tricks
Topic: Legit Reasons to divide content into several projects?
Replies: 3
Views: 3398

Re: Legit Reasons to divide content into several projects?

You might make one project with a separate folder for the content unique to each brand, and one for common content. Each brand gets a target to build its output. You can apply conditions to the folders to exclude brands A and B from brand C's target, etc., while the common folder has no conditions ...
by devjoe
Thu Feb 08, 2018 2:32 pm
Forum: Flare's General Discussion
Topic: UL lists counting?
Replies: 5
Views: 2556

Re: UL lists counting?

What you are showing is two separate numbered lists with other content between them. This looks like a case where the second list has had its start number set to 3, which is typical of material imported from Word or the like where there was no concept of having anything more than a single paragraph ...
by devjoe
Thu Feb 01, 2018 7:21 am
Forum: Printed Documentation Targets
Topic: Build failed: Access to the path: C:\My Projects...denied.
Replies: 11
Views: 26034

Re: Build failed: Access to the path: C:\My Projects...denie

Usually this is because you have the last build of the PDF open somewhere. If you opened in in a browser, you may have to completely close the browser before it releases its hold on the file.
by devjoe
Thu Feb 01, 2018 7:17 am
Forum: Styles, Stylesheets and XML
Topic: Style Updates: Import Style or Update Stylesheet Editor?
Replies: 4
Views: 2613

Re: Style Updates: Import Style or Update Stylesheet Editor?

What Choccie said is good advice.

When you are setting up a whole style sheet, trying to set 1000 properties via the style editor is a pain, and getting comfortable with the text of CSS is a good idea.

You will want to identify all the named styles as well as all the elements whose default styles ...
by devjoe
Thu Jan 25, 2018 7:25 am
Forum: Web-based Outputs
Topic: Customer wants to add bespoke content to HTML5 Help system
Replies: 4
Views: 1642

Re: Customer wants to add bespoke content to HTML5 Help syst

Trent, I have not done that, but ask around. There's probably somebody around here who tried installing Flare help on Linux who might have experience with that.
by devjoe
Thu Jan 25, 2018 7:22 am
Forum: Web-based Outputs
Topic: Showing H2/H3/H4s in search results?
Replies: 11
Views: 5541

Re: Showing H2/H3/H4s in search results?

Ah, yes, now I get what you are saying. On the search results page, the text listed as the title for each result is the title property of the topic, not any specific heading within the topic. If you leave your titles blank, Flare automatically fills them in with the first heading from the topic ...