[libvirt] [PATCH] docs: Format text in <p/> into a block

[Daniel P. Berrange]

On Fri, Dec 02, 2016 at 01:37:17PM +0100, Michal Privoznik wrote:
> On 02.12.2016 12:27, Daniel P. Berrange wrote:
> > On Fri, Dec 02, 2016 at 12:02:54PM +0100, Michal Privoznik wrote:
> >> With the rework of our webpage I've also noticed that we can make
> >> our <p/> block look more uniform: stretch the lines so that each
> >> has the equal width. Just like if you hit "align to block" in
> >> your favourite text editor.
> >>
> >> Signed-off-by: Michal Privoznik <mprivozn at redhat.com>
> >> ---
> >>  docs/generic.css | 1 +
> >>  1 file changed, 1 insertion(+)
> >>
> >> diff --git a/docs/generic.css b/docs/generic.css
> >> index a6b2354df..4c8887d6d 100644
> >> --- a/docs/generic.css
> >> +++ b/docs/generic.css
> >> @@ -14,6 +14,7 @@ p, ul, ol, dl {
> >>  p {
> >>    margin-top: 1em;
> >>    margin-bottom: 1em;
> >> +  text-align: justify;
> >>  }
> > 
> > Justified text ends up looking very ugly unless the layout engine is also
> > capable of doing automatic hyphenation of words - without hyphenation, if
> > you have a long word that gets pushed to the next line, you get huge whitespace
> > gaps between words.
> > 
> > More specific to the libvirt site - it looks very odd to have <p>
> > justified, but nothing else - eg looking at formatdomain.html, we end
> > up with a mix of justified and non-justified text, depending on whether
> > we've used a <li>, <dl> or <p> for the particular bit of docs.
> 
> So you're not against the idea if I include other elements too? Or we
> should postpone it until we have the automatic hyphenation engine?

I'm not really seeing any compelling benefit to justification and clear
downsides. The hyphenation mitigates it somewhat, but its still pretty
poor compared to how a proper print layout engine does justification,
to the extent that I don't really see any point.

This blog describes it in a clearer detail that I can:

  http://designforhackers.com/blog/never-justify-type-on-the-web/

...many other blogs say basically the same too

Regards,
Daniel
-- 
|: http://berrange.com      -o-    http://www.flickr.com/photos/dberrange/ :|
|: http://libvirt.org              -o-             http://virt-manager.org :|
|: http://entangle-photo.org       -o-    http://search.cpan.org/~danberr/ :|