Web builds - puzzling build log and output

[sdcinvan]

Hello all,

My Flare content folder holds multiple projects that are separate and built with their own independent Targets and TOCs. They all have common topics and all use a single common stylesheet.

When I began using the HTML target, I noticed that Flare was also publishing every other project or their topics. So, instead of seeing a folder of only the html topics that are designated by the Target TOC, the output folder has many sub-folders with all the other Flare projects. The published Target worked perfectly but there were no links to the other projects.

The build log shows a lot of inexplicable errors or warnings, such as:

Processing CSS: glb_resources\Stylesheets\glb_stylesheet.css...
Processing CSS: glb_resources\Stylesheets\mobidoc.css...
Processing CSS: glb_resources\Stylesheets\mobileskin.css...
Processing CSS: glb_resources\Stylesheets\printdoc.css...
Processing CSS: glb_resources\Stylesheets\webdoc.css...

...and later on in the log:
<LogEntry File="../../../Content/Resources/Stylesheets/UG_Styles.css" Message="Missing linked source file: D:\_Projects\Flare\007-0025NA-UG\Content\images\icons\question_icon.svg" LineIndex="-1" CharIndex="-1" Subsystem="Compiler" Target="007-0025NA-UG-HTM" ErrorID="10001" />

With the exception of glb_stylesheet.css, the above are old experimental stylesheets that are still in the resources folder but are temporarily dormant... meaning, there are no projects referencing these stylesheets and they have absolutely no relationship to the current build.
There are several places, within the same log, where it appears that Flare processes these stylesheets more than once.

Q. Why is Flare "processing" them?

Addtiionally...
Missing linked source file: D:\_Projects\Flare\007-0025NA-UG\Content\images\icons\question_icon.svg
Missing linked source file: D:\_Projects\Flare\007-0025NA-UG\Content\images\icons\CheckBox_Bullet.png
Processing CSS: Resources\Stylesheets\webdoc.css...
Missing linked source file: D:\_Projects\Flare\007-0025NA-UG\Content\images\icons\CheckBox_Bullet.png

These warnings are actually related to the dormant stylesheets... if Flare would properly ignore those stylesheets, these warnings would not get logged.

---------


Failed to copy and resize image: D:\_Projects\Flare\007-0025NA-UG\Content\glb_images\icons\ico_alert_NOTE_30x27.svg: Out of memory.
Failed to copy and resize image: D:\_Projects\Flare\007-0025NA-UG\Content\glb_images\icons\ico_examples.svg: Out of memory.
Failed to copy and resize image: D:\_Projects\Flare\007-0025NA-UG\Content\glb_images\icons\ico_alert_NOTE_30x27.svg: Out of memory.
Failed to copy and resize image: D:\_Projects\Flare\007-0025NA-UG\Content\glb_images\icons\ico_alert_NOTE_30x27.svg: Out of memory.
Failed to copy and resize image: D:\_Projects\Flare\007-0025NA-UG\Content\glb_images\icons\ico_alert_WARN_30x27.svg: Out of memory.
Failed to copy and resize image: D:\_Projects\Flare\007-0025NA-UG\Content\glb_images\icons\ico_alert_NOTE_30x27.svg: Out of memory.

A lot of these errors occurred! In fact, it seems like this error occurred for .svg icon in the entire publication. Strange thing is, the icons are still visible as .svg images.

And then later in the log, many more errors like this:

<LogEntry File="../../../Content/007-0025NA-UG/320_remote_replication.htm" Message="Failed to copy and resize image: D:\_Projects\Flare\007-0025NA-UG\Content\glb_images\icons\ico_alert_NOTE_30x27.svg: Out of memory." LineIndex="-1" CharIndex="-1" Subsystem="Compiler" Target="007-0025NA-UG-HTM" ErrorID="20010" />

Q. Can anyone explain why these errors are appearing for all .svg images? As I mentioned, the errors do not appear to affect the output.

---------

Applying master page WebMasterPage.flmsp...
Generated 006-0025NA-InstG\1g_xxxgetting_started.htm
Processing topic: 006-0025NA-InstG\907_provisioning.htm...
Missing linked source file: D:\_Projects\Flare\007-0025NA-UG\Content\images\icons\ico_Information.png
Applying master page WebMasterPage.flmsp...
Generated 006-0025NA-InstG\907_provisioning.htm
Processing topic: 006-0025NA-InstG\Copy of 1a_getting_started(instg).htm...


The project 006-0025NA-InstG and all its topics are not part of the Target I am building.

Q. Why is this build touching unrelated projects, and their topics?

---------

More madness!

Applying master page WebMasterPage.flmsp...
Generated appendix\m_appendix-Action_Itms_Activity_Strm_ref.htm
Processing topic: glb_topics\Copy of TEMPLATE.htm...
Link points outside project file:///D:/_Projects/Flare/001-0003NA-UG/Content/images/parts/0020_Rack_mount_SwitchStore_Block_oblique.png
Link points outside project file:///D:/_Projects/Flare/001-0003NA-UG/Content/Resources/Images/02_Workloads_top.png
Link points outside project file:///D:/_Projects/Flare/001-0003NA-UG/Content/Resources/Images/02_Workloads_top_hotspots.png


Nothing in this part of the log is related to the Target I am building!
001-0003NA-UG is not even available... not since 2013! Where is this coming from?

Q. Where is this obsolete and long ago deleted information being picked up from?

--------

Just as puzzling as the above, Analyzer v8 will not open this project! It will open any of the other projects but the one in question will not open, nor are there any error messages associated with opening it... nothing... as if I didn't attempt to open it. Please keep in mind that this is a working project with no known errors associated with publishing PDF and the HTML output does work (despite the strange errors).

Thank you,
Shawn

[sdcinvan]

Just as puzzling as the above, Analyzer v8 will not open this project! It will open any of the other projects but the one in question will not open, nor are there any error messages associated with opening it... nothing... as if I didn't attempt to open it. Please keep in mind that this is a working project with no known errors associated with publishing PDF and the HTML output does work (despite the strange errors).

Scratch that part! Discovered that my Dropbox sync was confusing Analyzer. I am now inspecting the project in Analyzer.

[sdcinvan]

I must be doing something wrong or misunderstanding how Analyzer works??

When I open a project, I expected Analyzer to only report any anything directly related to that project and ignore any other folders that are obviously unrelated to the project?

I only want Flare or Analyzer to process or analyze only what is specified in the TARGET AND THE TOC. Is that even possible?

This is how I have my folders set up:

Code: Select all

 Directory of D:\_Projects\Flare
<JUNCTION>     _Glb_project [\??\D:\Dropbox\_Glb_project]
<JUNCTION>     000-xxxx-ShortDocs [\??\D:\Dropbox\770-000xx-ShortDocs]
000-xxxx-LegalDocs
<DIR>          007-0025NA-UG
<DIR>          770-00011_12_UG_Rack_Rail
<DIR>          770-00018_TSA
<DIR>          770-00020-EULA
<DIR>          770-00021-TermCondSale
<DIR>          Output

Note: The <JUNCTION> folders are redirects to Dropbox synchronization. This works really well to recovering any deleted content over several months. Although I am 99% certain that it isn't causing any of these problems, I have temporarily removed the Junction attached to 007-0025NA-UG for the purpose of running Analyzer.

As you can see, all the main and unrelated Flare projects are located in this folder... . However, I also keep sub-projects (that share a lot of content) inside the 007-0025NA-UG:

Code: Select all

 Directory of D:\_Projects\Flare\007-0025NA-UG
007-0025NA-UG.flprj
<DIR>          Analyzer
<DIR>          Content
<DIR>          FileSync
<DIR>          Output
<DIR>          Project
MyHeaderFile.bas
MyHeaderFile.h
MyHeaderFile.inc
MyHeaderFile.properties

Skipping > Directory of D:\_Projects\Flare\007-0025NA-UG\Analyzer

Directory of D:\_Projects\Flare\007-0025NA-UG\Content
<DIR>          00000-maint_guide
<DIR>          006-0025NA-InstG
<DIR>          007-0025NA-UG
<DIR>          012-0002NA-StorPrG
<DIR>          205-0002NA-BstPrG
<DIR>          appendix
<DIR>          glb_images
<DIR>          glb_resources
<DIR>          glb_topics
<DIR>          images
<DIR>          Resources
<DIR>          _common

The folder D:\_Projects\Flare\007-0025NA-UG\Content is where I store all related documents that share content. The problem is, that when I publish 007-0025NA-UG, every one of these folders are included in the final project, even though none of them are linked together... at least, not in the 007-0025NA-UG TOC nor the Target.

Is my project folder hierarchy incorrect?

Note:
The folder's prefixed with glb_ are the Global Project Linked folders. Flare automatically syncs these folders before every build.

[ChoccieMuffin]

How are you importing your global project? Are these "optional extras" from the global project or from elsewhere?

I have a suggestion but I might be barking up the wrong tree, if so I apologise.

In your Globals project, condition everything you want to be included when you import the project (or if there are only a few bits that you don't want, condition them instead).
In the project you're importing into, edit the import file so that it ONLY imports the files that you want - use the Import Conditions box, and check the Auto-exclude non-tagged files (if you've conditioned the ones you want rather than the ones you don't want).

Imp.png

In your target project, clear out all the stuff you've imported so far. (You'll have to work out the best way to do this, depending on your working methods. We use SVN external to Flare and we only check in stuff that's not imported, so all I have to do is check out a "clean" version of the target project, but you may have other ways to do it.)

Not sure if this is any help, but you could give it a try.

There's also another option in the target that might help. On the Advanced tab, select the "Exclude content not linked directly or indirectly from the target" check box and see if that makes a difference.

[NorthEast]

Q. Why is Flare "processing" them?
Q. Why is this build touching unrelated projects, and their topics?

Flare help outputs will include everything in your Content folder, unless you tell it otherwise by :
- Setting the option on the target Advanced tab to Exclude content not linked directly or indirectly from the target (help).
- Using conditons to exclude the files.

I only want Flare or Analyzer to process or analyze only what is specified in the TARGET AND THE TOC. Is that even possible?

Nope, it works on a project level, not targets within the project. The same applies to Flare's reports.

[ChoccieMuffin]

Actually, in Analyzer you can get a report for topics not in a specific TOC, using a filter on the top of the right-hand pane. Don't think any of the others can be filtered like that, but it might be some help to you.