[libvirt] [PATCH] docs: Format text in <p/> into a block
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@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; } ul, ol { -- 2.11.0
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@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. 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/ :|
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@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? Michal
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@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/ :|
On Fri, Dec 02, 2016 at 01:28:05PM +0000, Daniel P. Berrange wrote:
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@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
Oh, if designers say so... But to be honest, they all use it (and show it) on pages that use 20% of my screen width, which is IMHO even more stupid.
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/ :|
-- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
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@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.
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/ :|
-- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
participants (3)
-
Daniel P. Berrange -
Martin Kletzander -
Michal Privoznik