[Freeswitch-docs] Black background in code snippets

Mario mario_fs at mgtech.com
Mon Jun 15 20:42:34 MSD 2015 

I have OS X 10.6-10.10 (safari), Linux (firefox), Windows XP (firefox and IE), and even…. OS/2 browsers. Remember you can’t please all of the people all of the time. Although I prefer the fonts I listed I can certainly live with what we have. Balance the wiki visual appearance with complexity and maintenance…..
Mario

> On Jun 15, 2015, at 7:33 AM, Bote Man <bote_radio at botecomm.com> wrote:
> 
> Yes, of course. But it is not enough for me to view a variety of pages to check them for sanity. Other browsers and other operating systems might present the page differently than what I see here. People will freak out if I make a change that looks OK for me, but others might not see the same thing that I do. That's the tricky part of CSS and why we should keep the changes small and simple. The Confluence help text has many warnings so I want to proceed with caution.
> 
> I would like to coordinate with you, Mario, and any others who have many different browsers and operating systems available to get everybody on irc at one time. After I am ready to test a change I will announce it on the irc channel and ask everybody to view a number of pages to see if they look sane. If not, I can roll it back immediately.
> 
> This will not be today, I will let you know.
> 
> Bote
> 
> 
>> -----Original Message-----
>> From: freeswitch-docs-bounces at lists.freeswitch.org [mailto:freeswitch-
>> docs-bounces at lists.freeswitch.org] On Behalf Of Stanislav Sinyagin
>> Sent: Monday, 15 June, 2015 10:24
>> To: FreeSWITCH Docs Team
>> Subject: Re: [Freeswitch-docs] Black background in code snippets
>> 
>> or just make a backup and roll back if needed :)
>> 
>> On Mon, Jun 15, 2015 at 4:17 PM, Bote Man <bote_radio at botecomm.com>
>> wrote:
>>> This is the introductory help text that worries me:
>>> 
>>> "You can customize the look and feel of Confluence by editing the global
>> stylesheet. This will also _overwrite all styles defined in custom global
>> themes_.
>>> Please note that the custom global stylesheet will not be applied to spaces
>> that define their own custom stylesheet or are using a theme."
>>> 
>>> Knowing how obtuse Confluence can be I want to research this to get it
>> right so I don't wipe out the style sheet for the entire site, although I see a
>> change I made a few months ago to make text wrap inside the code snippet
>> macros and it didn't seem to affect everything else in Confluence. I just don't
>> trust it any farther than I can throw it.
>>> 
>>> Since today is already spoken for I won't be able to mess with this right
>> away. The Confluence user help forums can often provide a wealth of
>> information so that's where I will start.
>>> 
>>> Bote
>>> 
>>> 
>>> 
>>>> -----Original Message-----
>>>> From: freeswitch-docs-bounces at lists.freeswitch.org [mailto:freeswitch-
>>>> docs-bounces at lists.freeswitch.org] On Behalf Of Stanislav Sinyagin
>>>> Sent: Monday, 15 June, 2015 10:01
>>>> To: FreeSWITCH Docs Team
>>>> Subject: Re: [Freeswitch-docs] Black background in code snippets
>>>> 
>>>> Monospace is completely fine -- probably it makes sense to make the
>>>> default font one size point smaller.
>>>> 
>>>> I just want a readable document, as it's not a terminal screen and not
>>>> a Emacs window (I actually use Emacs, but with white background and
>>>> syntax hiliting turned off :-)
>>>> 
>>>> Also it would be cool to have it printer-friendly, although it's
>>>> ridiculous to print those pages out :)
>>>> 
>>>> 
>>>> 
>>>> On Mon, Jun 15, 2015 at 3:57 PM, Bote Man
>> <bote_radio at botecomm.com>
>>>> wrote:
>>>>> I don’t know what fonts we have available.
>>>>> 
>>>>> 
>>>>> 
>>>>> Plus, each operating system and browser family has its own different
>> set of
>>>>> fonts only some of which intersect.
>>>>> 
>>>>> 
>>>>> 
>>>>> Confluence limits what we can do, so don’t get your hopes too high. It’s
>> a
>>>>> blunt instrument.
>>>>> 
>>>>> 
>>>>> 
>>>>> Bote
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> From: freeswitch-docs-bounces at lists.freeswitch.org
>>>>> [mailto:freeswitch-docs-bounces at lists.freeswitch.org] On Behalf Of
>> Mario
>>>>> Sent: Sunday, 14 June, 2015 14:44
>>>>> To: FreeSWITCH Docs Team
>>>>> Subject: Re: [Freeswitch-docs] Black background in code snippets
>>>>> 
>>>>> 
>>>>> 
>>>>> Another possibility to provide better reading is to use a thicker font
>>>>> without serifs for the white letters. Keep in mind that on terminal
>> sessions
>>>>> the letters are typically monospaced. Below are what it looks like now
>> and a
>>>>> a couple of samples to demonstrate, I kept the point since the same
>> (14)
>>>> but
>>>>> notice how they still take the same space. I wrote many computer
>> books
>>>> for
>>>>> classes and had a lot of experience testing fonts and found non-serif
>> best
>>>>> for commands/etc.
>>>>> 
>>>>> 
>>>>> 
>>>>> 
Current what I see now in Confluence - Courier New (note serifs):
sudo chown -R yourname:yourgroup local    # Modify the owner of the /usr/local directory to yours

Andale Mono (no serifs):
sudo chown -R yourname:yourgroup local    # Modify the owner of the /usr/local directory to yours

Monaco (I use this a lot in books for this purpose):
sudo chown -R yourname:yourgroup local    # Modify the owner of the /usr/local directory to yours

>>>>> 
>>>>> Mario G
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> On Jun 14, 2015, at 11:24 AM, Stanislav Sinyagin <ssinyagin at gmail.com>
>>>>> wrote:
>>>>> 
>>>>> 
>>>>> 
>>>>> the problem is, that the black code snippets pop out and my eyes have
>>>>> difficulty to actually detect the text on the page -- especially if
>>>>> there are lots of code snippets. The brain gets too much distraction
>>>>> and it's difficult to find the desired part on the screen.
>>>>> 
>>>>> The old wiki had a light-grey background for source code, and that was
>>>>> quite perfect.
>>>>> 
>>>>> 
>>>>> On Sun, Jun 14, 2015 at 6:00 PM, Bote Man
>> <bote_radio at botecomm.com>
>>>> wrote:
>>>>> 
>>>>> Really, it is the contrast between white characters and black
>> background. I
>>>>> simply chose that emacs theme to emulate a "glass tty", and Anthony is
>> a
>>>>> huge emacs fan.
>>>>> 
>>>>> All the other choices are either black or white background, so not much
>>>>> choice. It's nice to make it stand out from narrative text, however.
>>>>> 
>>>>> We could change the style sheet if I can ever figure out how. I haven't
>>>>> pursued it because there is a warning in the help about superseding
>>>>> everything else. I don't know if they mean it supersedes the affected
>>>>> element across the whole Confluence site or if it wipes out the entire
>> style
>>>>> sheet except for the changes. Knowing how stupid Confluence can be in
>>>> other
>>>>> areas I wouldn't be surprised if it's the latter.
>>>>> 
>>>>> I'll see about a soft charcoal color, or maybe a baby blue. :-)
>>>>> 
>>>>> Bote
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> -----Original Message-----
>>>>> From: freeswitch-docs-bounces at lists.freeswitch.org
>> [mailto:freeswitch-
>>>>> docs-bounces at lists.freeswitch.org] On Behalf Of Stanislav Sinyagin
>>>>> Sent: Sunday, 14 June, 2015 10:35
>>>>> To: FreeSWITCH Docs Team
>>>>> Subject: [Freeswitch-docs] Black background in code snippets
>>>>> 
>>>>> Maybe we change the default black background to something less
>>>>> annoying? it really distracts from reading.
>>>>> 
>>>>> _______________________________________________
>>>>> Freeswitch-docs mailing list
>>>>> Freeswitch-docs at lists.freeswitch.org
>>>>> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
>>>>> 
>>>>> 
>>>>> 
>>>>> _______________________________________________
>>>>> Freeswitch-docs mailing list
>>>>> Freeswitch-docs at lists.freeswitch.org
>>>>> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
>>>>> 
>>>>> 
>>>>> _______________________________________________
>>>>> Freeswitch-docs mailing list
>>>>> Freeswitch-docs at lists.freeswitch.org
>>>>> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> _______________________________________________
>>>>> Freeswitch-docs mailing list
>>>>> Freeswitch-docs at lists.freeswitch.org
>>>>> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
>>>>> 
>>>> 
>>>> _______________________________________________
>>>> Freeswitch-docs mailing list
>>>> Freeswitch-docs at lists.freeswitch.org
>>>> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
>>> 
>>> 
>>> _______________________________________________
>>> Freeswitch-docs mailing list
>>> Freeswitch-docs at lists.freeswitch.org
>>> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
>> 
>> _______________________________________________
>> Freeswitch-docs mailing list
>> Freeswitch-docs at lists.freeswitch.org
>> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs
> 
> 
> _______________________________________________
> Freeswitch-docs mailing list
> Freeswitch-docs at lists.freeswitch.org
> http://lists.freeswitch.org/mailman/listinfo/freeswitch-docs

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.freeswitch.org/pipermail/freeswitch-docs/attachments/20150615/86c87402/attachment-0001.html

Join us at ClueCon 2014 Aug 4-7, 2014
More information about the Freeswitch-docs mailing list