Modify

Opened 7 years ago

Closed 6 years ago

#15929 closed task (othersoftware)

guidelines for josm wiki tables

Reported by: Klumbumbus Owned by: team
Priority: normal Milestone:
Component: Wiki content Version:
Keywords: Cc: stoecker, Hb---

Description (last modified by Klumbumbus)

I don't really like the new style tables are written in the wiki (with line breaks). It makes the editing page confusing. See the comparison for Help/Menu/ImageryContextMenu. Any opinions?


Attachments (6)

wikiwithlinebreak.png (39.5 KB ) - added by Klumbumbus 7 years ago.
wikiwithoutlinebreak.png (35.0 KB ) - added by Klumbumbus 7 years ago.
longline.png (11.0 KB ) - added by Klumbumbus 7 years ago.
1280px_and_90chars.png (120.3 KB ) - added by Hb--- 7 years ago.
Replying to Don-vip: > When it fits on a single line, there's no need to add line breaks, I agree this is confusing. Seems that most JOSM developers have screens with a lot of pixels. So the Search is bigger than my screen in the German translation. Please see screenshot. Even --help needs line breaks now. Nearly all linux tools need only 83 to 86 characters to display their help in the terminal. Replying to Klumbumbus: > With line break style it is hard to find where the next table line starts as every code line start with ||. Well, with long lines it is hard to find where the next cell starts, see the screenshot. Really much more harder[[br]] For easier finding the table rows I made the indent in our example Help/Dialog/RelationList wider. Between the || and the content are now two to four space characters. Please give your opinion again.
withintentation.png (26.9 KB ) - added by Klumbumbus 7 years ago.
One-cell-one-line.jpg (138.2 KB ) - added by Hb--- 7 years ago.

Download all attachments as: .zip

Change History (16)

by Klumbumbus, 7 years ago

Attachment: wikiwithlinebreak.png added

by Klumbumbus, 7 years ago

Attachment: wikiwithoutlinebreak.png added

comment:1 by Klumbumbus, 7 years ago

Description: modified (diff)

comment:2 by Klumbumbus, 7 years ago

Description: modified (diff)

comment:3 by Don-vip, 7 years ago

When it fits on a single line, there's no need to add line breaks, I agree this is confusing.

by Klumbumbus, 7 years ago

Attachment: longline.png added

comment:4 by Klumbumbus, 7 years ago

Even if it doesn't fit on a single line I find it better as you better see in the code where the next table line start (see screenshot). With line break style it is hard to find where the next table line starts as every code line start with ||.

comment:5 by stoecker, 7 years ago

I'm used to it from Wikipedia. It is not nice, but probably this is a fight you only can loose ;-)

by Hb---, 7 years ago

Attachment: 1280px_and_90chars.png added

Replying to Don-vip:
> When it fits on a single line, there's no need to add line breaks, I agree this is confusing.
Seems that most JOSM developers have screens with a lot of pixels. So the Search is bigger than my screen in the German translation. Please see screenshot.

Even --help needs line breaks now. Nearly all linux tools need only 83 to 86 characters to display their help in the terminal.


Replying to Klumbumbus:
> With line break style it is hard to find where the next table line starts as every code line start with ||.
Well, with long lines it is hard to find where the next cell starts, see the screenshot. Really much more harder[[br]]
For easier finding the table rows I made the indent in our example Help/Dialog/RelationList wider. Between the || and the content are now two to four space characters. Please give your opinion again.

by Klumbumbus, 7 years ago

Attachment: withintentation.png added

comment:6 by Klumbumbus, 7 years ago

Seems that most JOSM developers have screens with a lot of pixels.

1280*1024 is really not the standard anymore.

Please give your opinion again.

This is even more confusing. It looks like the code lines without indentation start a new table line, but it is actually the last code line of a table line.


comment:7 by Hb---, 7 years ago

Please see the next sample on Help/Menu/PhotoLayer.

Now the first line for a <td> is normal and has only one space as indent. All following lines for all <td> in that table row <tr> have an indent with a 4 digits. This allows editors easily to see where a new row beginns.

by Hb---, 7 years ago

Attachment: One-cell-one-line.jpg added

in reply to:  6 ; comment:8 by Hb---, 7 years ago

Replying to Klumbumbus:

1280*1024 is really not the standard anymore.

Maybe, but the field of vision does not grow with more pixel.

This is even more confusing. It looks like the code lines without indentation start a new table line, but it is actually the last code line of a table line.

For tables which have the main content in the last column that seemed acceptable.
But there is a better solution.

  • Each content cell has one line in WikiText.
  • Each line ends with ||\, even for the last cell in a row.
  • Row ends with ||.
  • Empty rows are |||| without duplicating || for each empty cell.
Last edited 6 years ago by Hb--- (previous) (diff)

in reply to:  8 comment:9 by Klumbumbus, 7 years ago

Replying to Hb---:

Replying to Klumbumbus:

1280*1024 is really not the standard anymore.

Maybe, but the field of vision does not grow with more pixel.

It does. compare attachment:1280px_and_90chars.png​ (green ellipses) with attachment:longline.png

For tables which have the main content in the last column that seemed acceptable.
But there is a better solution.

I still don't like it. But I can't forbid you to do it this way.

comment:10 by Hb---, 6 years ago

Resolution: othersoftware
Status: newclosed

Modify Ticket

Change Properties
Set your email in Preferences
Action
as closed The owner will remain team.
as The resolution will be set.
The resolution will be deleted. Next status will be 'reopened'.

Add Comment


E-mail address and name can be saved in the Preferences .
 
Note: See TracTickets for help on using tickets.