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

Martin Kletzander mkletzan at redhat.com
Fri Dec 2 13:59:30 UTC 2016

On Fri, Dec 02, 2016 at 11:27:10AM +0000, 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.

I haven't checked all the pages, but I think there's way more paragraphs
that look way cleaner and better with the justified text than there are
occurrences of very long unbreakable words that make one line look too
spacious.  But of course it should be added to dd, li as well as p.

I think it wouldn't look good with our old page, but with the new
layout, it makes it look way clearer.

>|: 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/ :|
>libvir-list mailing list
>libvir-list at redhat.com
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: Digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20161202/9c3b8676/attachment-0001.sig>

More information about the libvir-list mailing list