Confused by some style import problems

This forum is for all Flare issues related to importing files or projects.

Confused by some style import problems

Postby JoeWeinmunson on Tue Oct 30, 2018 2:09 pm

It's my first full day working in Flare. I've mostly succeeded in importing our .CHM file but I'm running into some style problems.
Code: Select all
CSS: C:\Users\litlf\Documents\My Projects\Trash Flow Help file\Content\BillTo_Account.html: CSS: Invalid float: middle
CSS: C:\Users\litlf\Documents\My Projects\Trash Flow Help file\Content\BillTo_Account.html: CSS: Invalid font-style: bold

Unlike in the sample project used in the Flare tutorial, I don't yet have a separate "Resources" folder so the one CSS file is just in the "Content" folder. I think I understand what the above messages are trying to tell me, but for the life of me I can't tell how to edit the classes. If there's something wrong with the bold style here, what am I supposed to do to change it?
classConfusion.png
You do not have the required permissions to view the files attached to this post.
JoeWeinmunson
Jr. Propeller Head
 
Posts: 4
Joined: Tue Oct 30, 2018 12:05 pm

Re: Confused by some style import problems

Postby Nita Beck on Tue Oct 30, 2018 4:22 pm

Welcome to the forums, Joe! :)

I don’t think the issue is in your stylesheet. Rather, Flare has found two invalid CSS attributes in the BillTo_Accounts.html file. The first is that “middle” is not a valid value for the “float” attribute. The second is that “bold” is not a valid value for the “font-style” attribute.

At a minimum, you can go into the Text Editor for that topic and fix these bits of code by hand, perhaps by removing it outright. (That’s what I’d do, as I suspect that this code represents inline formatting, and a best practice is to minimize the use of inline formatting to the greatest extent possible.)

To learn more about what values are valid for “float” and for “font-style”, see the following. Also check out “font-weight,” which does accept “bold” as a valid value.

https://www.w3schools.com/cssref/pr_class_float.asp
http://www.w3schools.com/cssref/pr_font_font-style.asp
https://https://www.w3schools.com/cssref/pr_font_weight.asp

I hope this helps.
Nita
Image
Content Strategist / Information Architect / Flare Consultant: http://beck-communications.com
Manager, Rochester Flare User Group: http://www.facebook.com/RochesterFlareUserGroup
Nita Beck
Senior Propellus Maximus
 
Posts: 3038
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Confused by some style import problems

Postby JoeWeinmunson on Thu Nov 01, 2018 8:50 am

Thank you, I was able to find the CSS problems and fix them. Having said that, not everyone who needs to use Flare at our company has a firm grasp on CSS and XML. On a purely mechanical level, isn't there some way to edit a stylesheet in Flare without using the text editor? If you look at the screenshot above I could not find a single way to alter the stylesheet other than to switch to the text editor.
JoeWeinmunson
Jr. Propeller Head
 
Posts: 4
Joined: Tue Oct 30, 2018 12:05 pm

Re: Confused by some style import problems

Postby JoeWeinmunson on Thu Nov 01, 2018 10:05 am

OK, I was able to identify the problem styles and fix that. Thanks! For the future, how can I do that without needing to manually edit the stylesheet in the text editor? I ask because some of our users here are not experts in CSS and XML. If you look at the Flare screenshot in my above post, I absolutely could not figure out how to use the Flare interface to add a new style or change an existing one.
JoeWeinmunson
Jr. Propeller Head
 
Posts: 4
Joined: Tue Oct 30, 2018 12:05 pm

Re: Confused by some style import problems

Postby Nita Beck on Thu Nov 01, 2018 12:24 pm

JoeWeinmunson wrote:OK, I was able to identify the problem styles and fix that. Thanks! For the future, how can I do that without needing to manually edit the stylesheet in the text editor? I ask because some of our users here are not experts in CSS and XML. If you look at the Flare screenshot in my above post, I absolutely could not figure out how to use the Flare interface to add a new style or change an existing one.


A couple of things:

The manual edits I suggested you make in the text editor were not in a stylesheet. They were in that one topic for which Flare threw up errors. The stylesheet itself had nothing to do with the errors you needed to fix. That's why I didn't offer any advice about how to use the Stylesheet Editor, because I wasn't telling you to go there.

Without meaning to express one iota of disrespect, to use Flare properly and creatively, one absolutely needs to understand CSS, HTML, and, to a certain extent, XML. Flare isn't a word processor. Even occasional and new users of Flare need to learn the basics of CSS in particular.

In Flare's Help, you could start here to learn the basics about stylesheets and working with the Stylesheet Editor:
https://help.madcapsoftware.com/flare2018/Content/Flare/Styles/About-Styles-Stylesheets.htm
https://help.madcapsoftware.com/flare2018/Content/Flare/Styles/About-Regular-Stylesheets.htm -- This one covers the Stylesheet Editor.

Additionally, perhaps have your users work their way through some of the free MadCap webinars on CSS. Some are basic, some advanced:

https://www.madcapsoftware.com/webinars/cascading-style-sheets-css-part-1-introduction-overview/
https://www.madcapsoftware.com/webinars/cascading-style-sheets-css-part-2-fonts-and-beyond/
https://www.madcapsoftware.com/webinars/cascading-style-sheets-css-part-3-images/
https://www.madcapsoftware.com/webinars/five-css-techniques-every-technical-writer-should-know-part-1/
https://www.madcapsoftware.com/webinars/advanced-css-best-practices-formatting-madcap-flare/

Finally, depending on how recently your company's licenses of Flare were purchased, you might be able to take advantage of MadCap's FREE online training for new users. You'd need to speak with your sales rep to see if your licenses qualify.

I am sincerely trying to help, not to overwhelm or appear smug.
Nita
Image
Content Strategist / Information Architect / Flare Consultant: http://beck-communications.com
Manager, Rochester Flare User Group: http://www.facebook.com/RochesterFlareUserGroup
Nita Beck
Senior Propellus Maximus
 
Posts: 3038
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Confused by some style import problems

Postby JoeWeinmunson on Thu Nov 01, 2018 1:30 pm

OK thank you, I understand. Let me go through those tutorials about working with the stylesheet editor and if I run into any problems I will deal with it that way. Thanks for your help.
JoeWeinmunson
Jr. Propeller Head
 
Posts: 4
Joined: Tue Oct 30, 2018 12:05 pm


Return to Importing

Who is online

Users browsing this forum: No registered users and 4 guests