[pmwiki-users] FAQ Page Layout

[Benjamin Wilson]

Although, if we did not use the text-indent, there would be no need for 
a more fancy markup than Q:/A:. That is, the Q: would be bold--or in the 
case of Google, it would be in a stylish display block. The A: would 
just list the answer. That's what we have right now. So, in the 
interests of KISS, to maintain the _status quo_ is optimal. We just need 
to change the markup a bit. It presently is this:

## Q: and A:
Markup('^Q:', 'block', '/^Q:(.*)$/', "<:block><p class='question'>$1</p>");
Markup('^A:', 'block', '/^(A:.*)$/', "<:block><p class='answer'>$1</p>");

I would say change them from [p] to [div].

Ben


Benjamin Wilson wrote:
> I should say first off I don't mean to come off so adversarial. I'm a 
> proponent of KISS and of not fixing what is not broken.
> 
> Your observations are valid--that it is logical to text-intent the 
> answer paragraph; that the Q: does not have to be bold; we need TOC in 
> the Core; and that we need multi-block A: markup.
> 
> I listed the sites only to show that if taken in the aggregate, we can 
> argue both points and personal preferences to the detriment of us all. :-)
> 
> I seek markup that is very malliable to the admin and very simple.
> 
> H. Fox wrote:
> 
> [snip]
> 
>> I doubt that.  Let's agree to disagree about the probable quality of
>> Google's UI people.
> 
> 
> I think we both agree Google does very well. It's all that Python they 
> program, methinks.
> 
>>> ## Q: and A:
> 
> 
> [snip]
> 
>> Those are good, but the answer only spans one "paragraph".  A second
>> paragraph or a code block would need to be indented separately.  In
>> other words, this markup
>>
>>     Q: How do I turn on the ?action=diag and ?action=phpinfo actions?
>>     A: Use
>>         $EnableDiag = 1;
>>     in your config.php file.
>>
>> produces the DT, the DD, the code block, and a paragraph.  If you
>> styled answers to be in red text, only "A: Use" would render in red.
>>
>> It would be better to have the answer be in one block.
> 
> 
> Then(?):
> 
> (:Q Question goes here:)
> (:A:)
> Answer goes here.
> (:Aend:)
> 
> DD works with each paragraph. Alternatively, we just DIV everything and 
> get the same result:
> 
> (:div class=faq:)
> Q: Question goes here
> A: Answer goes here
> 
> Q: Question
> A: Answer
> (:divend:)
> 
> Then use the Q:/A: markup to have Q display to the left where the 
> "normal" behavior in that display block is to text-indent.
> 
>> Certainly not.  A Google search for [faq q] comes up with 17000 hits.
> 
> 
> A lot of which are false positives, as I found out. :-)
> 
>>> "Show me a set of numbers that prove your point, and I'll introduce you
>>> to my statistician who will disprove your point with the same 
>>> numbers." :-)
>>
>>
>>
>> True, but I'm trying to figure out the best solution for the FAQ page,
>> not win a numbers contest.  Besides, my statistician had a higher
>> grade point average than yours.  ;-)
> 
> 
> That's true: "A students work for C students." ;-)
> 
>> I'm hoping the FAQ page can dramatically improve before the 2.0 release.
> 
> 
> Ben
> 
> 
> _______________________________________________
> pmwiki-users mailing list
> pmwiki-users at pmichaud.com
> http://host.pmichaud.com/mailman/listinfo/pmwiki-users
> 
> 
> 
>