Re: [Freeswitch-docs] Confluence quirks
Sorry, Jim. I just rolled back home from ClueCon so I've been out of the loop. I hope you asked this on the freeswitch-docs mailing list as the others might have ideas. Macros Yeah, I created the 'fc' macro as a shortcut. I have mixed feelings on the code styling. I really, really, REALLY do not get dark blue text on a black background; who in the world thought that would be a good idea? That's the friggin default for common elements shown by LS_COLORS on most linux distros and apparently Confluence uses it liberally. Go figure. Overall I'm trying to lend a consistent style so that Confluence looks like real documentation and not the mish-mash that the old MediaWiki became with everybody doing his own thing. if it looks good, do it. Editor Atlassian likes to crow about how reliable the Confluence editor is. Yeah, right. It frequently does weird stuff for me. My best advice is to get all the text onto the page first, then go back and style it. Moving tables and other macro elements around typically results in shenanigans. L I used Compare Versions successfully recently. It could be that it didn't have a proper earlier version to use as a datum for comparison, but that's just a guess. I'm digging out from under all these e-mails and whatnot that have piled up in my 2 week absence, so thanks for your efforts! Bote From: Jim Hayes [mailto:jhayes@jhayes.org] Sent: Thursday, 31 July, 2014 00:01 To: Bote Man; William King Subject: Quick check-in So I’ve been slowly working my way through the XML dialplan page, turning it into something that I would have liked to have read when I brought up my first system. Can you look at what I’ve done so far and make sure I’m not on the wrong track? Issues I’ve encountered so far: * The {fc macro doesn’t let me configure anything other than the “Caption”. So when I try to set it to emacs mode or turn on XML formatting (it really does make the code more readable, IMHO) I have to switch to the Confluence code macro, losing the Caption field. Which should I use? What are the benefits of the “Caption” field? * Mysteriously, all of my example text disappeared last night while I was messing with a table position in the middle of the doc. Seen that before? * The compare versions feature doesn’t seem to work for me. It either gives me an error or tells me that the compare process took more than 30 seconds. Is this a known issue? Anyway, I should be finished in a couple of days. It’s a long slog through that stuff. :-) -Jimbo
participants (1)
-
Bote Man