viewworkbook 0.1.3 → 0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,361 +1,64 @@
1
- <?xml version="1.0" encoding="utf-8" ?>
1
+ <?xml version="1.0" encoding="utf-8"?>
2
2
  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
3
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
4
  <head>
5
5
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6
- <meta name="generator" content="Docutils 0.13.1: http://docutils.sourceforge.net/" />
6
+ <meta name="generator" content="Docutils 0.21.2: https://docutils.sourceforge.io/" />
7
7
  <title>Viewworkbook</title>
8
8
  <style type="text/css">
9
9
 
10
10
  /*
11
- :Author: David Goodger (goodger@python.org)
12
- :Id: $Id: html4css1.css 7952 2016-07-26 18:15:59Z milde $
13
- :Copyright: This stylesheet has been placed in the public domain.
11
+ :Author: Michael Uplawski
12
+ :Contact: michael.uplawski@uplawski.eu
13
+ :License: WTFPL 2.0, see http://www.wtfpl.net/about/
14
14
 
15
- Default cascading style sheet for the HTML output of Docutils.
16
-
17
- See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
18
- customize this style sheet.
19
- */
20
-
21
- /* used to remove borders from tables and images */
22
- .borderless, table.borderless td, table.borderless th {
23
- border: 0 }
24
-
25
- table.borderless td, table.borderless th {
26
- /* Override padding for "table.docutils td" with "! important".
27
- The right padding separates the table cells. */
28
- padding: 0 0.5em 0 0 ! important }
29
-
30
- .first {
31
- /* Override more specific margin styles with "! important". */
32
- margin-top: 0 ! important }
33
-
34
- .last, .with-subtitle {
35
- margin-bottom: 0 ! important }
36
-
37
- .hidden {
38
- display: none }
39
-
40
- .subscript {
41
- vertical-align: sub;
42
- font-size: smaller }
43
-
44
- .superscript {
45
- vertical-align: super;
46
- font-size: smaller }
47
-
48
- a.toc-backref {
49
- text-decoration: none ;
50
- color: black }
51
-
52
- blockquote.epigraph {
53
- margin: 2em 5em ; }
54
-
55
- dl.docutils dd {
56
- margin-bottom: 0.5em }
57
-
58
- object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] {
59
- overflow: hidden;
60
- }
61
-
62
- /* Uncomment (and remove this text!) to get bold-faced definition list terms
63
- dl.docutils dt {
64
- font-weight: bold }
65
- */
66
-
67
- div.abstract {
68
- margin: 2em 5em }
69
-
70
- div.abstract p.topic-title {
71
- font-weight: bold ;
72
- text-align: center }
73
-
74
- div.admonition, div.attention, div.caution, div.danger, div.error,
75
- div.hint, div.important, div.note, div.tip, div.warning {
76
- margin: 2em ;
77
- border: medium outset ;
78
- padding: 1em }
79
-
80
- div.admonition p.admonition-title, div.hint p.admonition-title,
81
- div.important p.admonition-title, div.note p.admonition-title,
82
- div.tip p.admonition-title {
83
- font-weight: bold ;
84
- font-family: sans-serif }
85
-
86
- div.attention p.admonition-title, div.caution p.admonition-title,
87
- div.danger p.admonition-title, div.error p.admonition-title,
88
- div.warning p.admonition-title, .code .error {
89
- color: red ;
90
- font-weight: bold ;
91
- font-family: sans-serif }
92
-
93
- /* Uncomment (and remove this text!) to get reduced vertical space in
94
- compound paragraphs.
95
- div.compound .compound-first, div.compound .compound-middle {
96
- margin-bottom: 0.5em }
97
-
98
- div.compound .compound-last, div.compound .compound-middle {
99
- margin-top: 0.5em }
15
+ Stylesheet for use with Docutils.
100
16
  */
101
17
 
102
- div.dedication {
103
- margin: 2em 5em ;
104
- text-align: center ;
105
- font-style: italic }
106
-
107
- div.dedication p.topic-title {
108
- font-weight: bold ;
109
- font-style: normal }
110
-
111
- div.figure {
112
- margin-left: 2em ;
113
- margin-right: 2em }
114
-
115
- div.footer, div.header {
116
- clear: both;
117
- font-size: smaller }
118
-
119
- div.line-block {
120
- display: block ;
121
- margin-top: 1em ;
122
- margin-bottom: 1em }
123
-
124
- div.line-block div.line-block {
125
- margin-top: 0 ;
126
- margin-bottom: 0 ;
127
- margin-left: 1.5em }
128
-
129
- div.sidebar {
130
- margin: 0 0 0.5em 1em ;
131
- border: medium outset ;
132
- padding: 1em ;
133
- background-color: #ffffee ;
134
- width: 40% ;
135
- float: right ;
136
- clear: right }
137
-
138
- div.sidebar p.rubric {
139
- font-family: sans-serif ;
140
- font-size: medium }
141
-
142
- div.system-messages {
143
- margin: 5em }
144
-
145
- div.system-messages h1 {
146
- color: red }
18
+ /* The defaults for docutils */
19
+ @import url(html4css1.css);
147
20
 
148
- div.system-message {
149
- border: medium outset ;
150
- padding: 1em }
151
-
152
- div.system-message p.system-message-title {
153
- color: red ;
154
- font-weight: bold }
155
-
156
- div.topic {
157
- margin: 2em }
158
-
159
- h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
160
- h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
161
- margin-top: 0.4em }
162
-
163
- h1.title {
164
- text-align: center }
165
-
166
- h2.subtitle {
167
- text-align: center }
168
-
169
- hr.docutils {
170
- width: 75% }
171
-
172
- img.align-left, .figure.align-left, object.align-left, table.align-left {
173
- clear: left ;
174
- float: left ;
175
- margin-right: 1em }
176
-
177
- img.align-right, .figure.align-right, object.align-right, table.align-right {
178
- clear: right ;
179
- float: right ;
180
- margin-left: 1em }
181
-
182
- img.align-center, .figure.align-center, object.align-center {
183
- display: block;
184
- margin-left: auto;
185
- margin-right: auto;
21
+ body {
22
+ background-color:#300020;
23
+ font-family: Verdana,Helvetica,Univers;
24
+ color:#f0f0f0;
25
+ color:#f0f0f0;
186
26
  }
187
27
 
188
- table.align-center {
189
- margin-left: auto;
190
- margin-right: auto;
28
+ h1 {color:cyan;font-size:1.5em;}
29
+ h1.title {color:#a0a0f0;font-size:2em;}
30
+ h2 {color:#ffffa0;}
31
+
32
+ p, ul.simple, ol.simple, dt {margin-left:2em;}
33
+ p.first {font-weight:bold;}
34
+ dd {margin-left:4em;}
35
+ td {color:#f0f080;}
36
+
37
+ /* correct left margin of nested block tags*/
38
+ dd {}
39
+ dd p, li p {margin-left:0;}
40
+ dd * ul {margin-left:0 ! important; }
41
+ dd ul {margin-left:0 ! important; }
42
+ dd dl dt, dd dl dd {margin-left:0 ! important;}
43
+ dt {font-weight:bold;}
44
+ dt, dd {color:#f0f0f0}
45
+
46
+ tt.docutils {color:#000080;
47
+ background-color:#a080a0;
48
+ padding-left:3px;
49
+ padding-right:3px;
50
+ white-space:nowrap;
191
51
  }
192
52
 
193
- .align-left {
194
- text-align: left }
195
-
196
- .align-center {
197
- clear: both ;
198
- text-align: center }
53
+ a.external {color:#ff90ff;}
199
54
 
200
- .align-right {
201
- text-align: right }
202
-
203
- /* reset inner alignment in figures */
204
- div.align-right {
205
- text-align: inherit }
206
-
207
- /* div.align-center * { */
208
- /* text-align: left } */
209
-
210
- .align-top {
211
- vertical-align: top }
212
-
213
- .align-middle {
214
- vertical-align: middle }
215
-
216
- .align-bottom {
217
- vertical-align: bottom }
218
-
219
- ol.simple, ul.simple {
220
- margin-bottom: 1em }
221
-
222
- ol.arabic {
223
- list-style: decimal }
224
-
225
- ol.loweralpha {
226
- list-style: lower-alpha }
227
-
228
- ol.upperalpha {
229
- list-style: upper-alpha }
230
-
231
- ol.lowerroman {
232
- list-style: lower-roman }
233
-
234
- ol.upperroman {
235
- list-style: upper-roman }
236
-
237
- p.attribution {
238
- text-align: right ;
239
- margin-left: 50% }
240
-
241
- p.caption {
242
- font-style: italic }
243
-
244
- p.credits {
245
- font-style: italic ;
246
- font-size: smaller }
247
-
248
- p.label {
249
- white-space: nowrap }
250
-
251
- p.rubric {
252
- font-weight: bold ;
253
- font-size: larger ;
254
- color: maroon ;
255
- text-align: center }
256
-
257
- p.sidebar-title {
258
- font-family: sans-serif ;
259
- font-weight: bold ;
260
- font-size: larger }
261
-
262
- p.sidebar-subtitle {
263
- font-family: sans-serif ;
264
- font-weight: bold }
265
-
266
- p.topic-title {
267
- font-weight: bold }
268
-
269
- pre.address {
270
- margin-bottom: 0 ;
271
- margin-top: 0 ;
272
- font: inherit }
273
-
274
- pre.literal-block, pre.doctest-block, pre.math, pre.code {
275
- margin-left: 2em ;
276
- margin-right: 2em }
277
-
278
- pre.code .ln { color: grey; } /* line numbers */
279
- pre.code, code { background-color: #eeeeee }
280
- pre.code .comment, code .comment { color: #5C6576 }
281
- pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
282
- pre.code .literal.string, code .literal.string { color: #0C5404 }
283
- pre.code .name.builtin, code .name.builtin { color: #352B84 }
284
- pre.code .deleted, code .deleted { background-color: #DEB0A1}
285
- pre.code .inserted, code .inserted { background-color: #A3D289}
286
-
287
- span.classifier {
288
- font-family: sans-serif ;
289
- font-style: oblique }
290
-
291
- span.classifier-delimiter {
292
- font-family: sans-serif ;
293
- font-weight: bold }
294
-
295
- span.interpreted {
296
- font-family: sans-serif }
297
-
298
- span.option {
299
- white-space: nowrap }
300
-
301
- span.pre {
302
- white-space: pre }
303
-
304
- span.problematic {
305
- color: red }
306
-
307
- span.section-subtitle {
308
- /* font-size relative to parent (h1..h6 element) */
309
- font-size: 80% }
310
-
311
- table.citation {
312
- border-left: solid 1px gray;
313
- margin-left: 1px }
314
-
315
- table.docinfo {
316
- margin: 2em 4em }
317
-
318
- table.docutils {
319
- margin-top: 0.5em ;
320
- margin-bottom: 0.5em }
321
-
322
- table.footnote {
323
- border-left: solid 1px black;
324
- margin-left: 1px }
325
-
326
- table.docutils td, table.docutils th,
327
- table.docinfo td, table.docinfo th {
328
- padding-left: 0.5em ;
329
- padding-right: 0.5em ;
330
- vertical-align: top }
331
-
332
- table.docutils th.field-name, table.docinfo th.docinfo-name {
333
- font-weight: bold ;
334
- text-align: left ;
335
- white-space: nowrap ;
336
- padding-left: 0 }
337
-
338
- /* "booktabs" style (no vertical lines) */
339
- table.docutils.booktabs {
340
- border: 0px;
341
- border-top: 2px solid;
342
- border-bottom: 2px solid;
343
- border-collapse: collapse;
55
+ blockquote {background-color:#400020;
56
+ padding:0.5em;
57
+ border-radius:1em;
58
+ border-style:dotted;
59
+ border-width:0.5pt;
344
60
  }
345
- table.docutils.booktabs * {
346
- border: 0px;
347
- }
348
- table.docutils.booktabs th {
349
- border-bottom: thin solid;
350
- text-align: left;
351
- }
352
-
353
- h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
354
- h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
355
- font-size: 100% }
356
61
 
357
- ul.auto-toc {
358
- list-style-type: none }
359
62
 
360
63
  </style>
361
64
  </head>
@@ -370,26 +73,32 @@ ul.auto-toc {
370
73
  </div>
371
74
  <div class="section" id="description">
372
75
  <h1>DESCRIPTION</h1>
373
- <p>Viewworkbook lets you read spreadsheet-files in text-mode, in a terminal
374
- window. It reproduces the tables which are contained in a spreadsheet file and
76
+ <p>ViewWorkbook allows you to read spreadsheet files in text mode in a terminal
77
+ window. It reproduces the tables contained in a spreadsheet file and It also
375
78
  lets you navigate through the sheets. The visible part of a sheet is limited
376
- laterally and horizontally by the terminal-size but can be scrolled. You can
377
- adapt the width of table-columns, to render the table more readable and
378
- finally, if you wish, save tables to a text-file. To the author of the
379
- program, the utility serves to take a quick glance at spreadsheets that are
380
- received via email, in the Mutt mail-client, which is itself a terminal
79
+ laterally and horizontally by the size of the terminal, but you can scroll
80
+ through it. You can adapt the width of table columns to make the table more
81
+ readable. Finally, you can save tables to a text file if you wish. For the
82
+ author of the program, the utility serves to quickly glance at spreadsheets
83
+ that are received via email in the Mutt mail client, which is a terminal
381
84
  application.</p>
382
- <p>The supported spreadsheet formats are those which are handled by the Ruby-gem
383
- &quot;<strong>roo</strong>&quot; (February 2017):</p>
85
+ <p>Supported spreadsheet formats are those handled by the Ruby gem &quot;<strong>roo</strong>&quot;
86
+ (2024, roo 2.10.1):</p>
87
+ <ul class="simple">
88
+ <li>Microsoft™ Excel 2007 - 2013 formats (<strong>xlsx</strong>, <strong>xlsm</strong>)</li>
89
+ <li>LibreOffice / OpenOffice.org formats (<strong>ods</strong>)</li>
90
+ <li>CSV</li>
91
+ <li>Microsoft™ Excel 97, Excel 2002 XML, and Excel 2003 XML formats (<strong>xls</strong>,
92
+ <strong>xml</strong>)</li>
93
+ </ul>
94
+ <p>Additionally also</p>
384
95
  <ul class="simple">
385
- <li>Microsoft's <strong>xls</strong> and <strong>xlsx</strong>,</li>
386
- <li>the OpenDocument spreadsheet <strong>ods</strong></li>
387
- <li>and the SoftMaker™ spreadsheet formats <strong>pmd</strong> and <strong>pmdx</strong>.</li>
96
+ <li>The SoftMakerspreadsheet formats <strong>pmd</strong> and <strong>pmdx</strong>.</li>
388
97
  </ul>
389
98
  </div>
390
99
  <div class="section" id="options">
391
100
  <h1>Options</h1>
392
- <p>Other than the path to the spreadsheet file, viewworkbook does currently not
101
+ <p>Other than the path to the spreadsheet file, viewworkbook does not currently
393
102
  interpret any command line arguments.</p>
394
103
  <div class="section" id="menu-commands">
395
104
  <h2>Menu commands</h2>
@@ -448,40 +157,41 @@ below the current table:</p>
448
157
  </tbody>
449
158
  </table>
450
159
  <p><strong>value (v) * save to file (f) * sheet (s) * column (c) * up(i) * down(k) * left(j) * right(l) * quit (q) *</strong></p>
451
- <p>When you enter one of the hotkeys, a command can be executed directly (like &quot;q&quot;
452
- to terminate the program), a sub-menu may be shown (like with &quot;c&quot; which shall
453
- give you control on column properties) or you are confronted with an input
454
- invitation (like with &quot;v&quot;, where you have to enter a cell-reference). Read on
455
- for an explanation of each menu command.</p>
160
+ <p>When you press one of the hotkeys, you can execute a command directly (like &quot;q&quot;
161
+ to terminate the program) or a submenu may appear (like with &quot;c&quot; which gives
162
+ you control over column properties) or you may be prompted for input (like with
163
+ &quot;v&quot;, where you have to enter a cell reference). Read on for an explanation of
164
+ each menu command.</p>
456
165
  <blockquote>
457
166
  <dl class="docutils">
458
167
  <dt>value (v)</dt>
459
168
  <dd>display the value from a cell. This is useful, when columns are not wide
460
- enough to show complete values. After entering &quot;<strong>v</strong>&quot;, you are
169
+ enough to show the full value. After entering &quot;<strong>v</strong>&quot;, you are
461
170
  immediately invited to enter a cell reference. Cells are referenced in
462
- the format &quot;Column:Row&quot;, e.g. D:12 for the cell in column &quot;D&quot; and row
171
+ the format &quot;column:row&quot;, e.g. D:12 for the cell in column &quot;D&quot; and row
463
172
  &quot;12&quot;.</dd>
464
173
  <dt>save to file (f)</dt>
465
- <dd>Save the current or all tables to a text file. The command does initially
466
- show two alternative sub-commands:</dd>
174
+ <dd>Save the current table or all tables to a text file. Initially, the command
175
+ shows two alternative sub-commands:</dd>
467
176
  <dt>Current sheet (c) * all sheets (a)</dt>
468
- <dd>Independently of your choice, in the next step you will have to enter the
469
- path to the output file. You will be warned, if the file already exists
470
- and may choose to either overwrite the existing file or name a different
471
- one.</dd>
177
+ <dd>Regardless of your choice, you will be prompted to enter the output file
178
+ path in the next step. You will receive a warning, if the file already
179
+ exists at which point you can choose to either overwrite the existing file
180
+ or give it a different name.</dd>
472
181
  <dt>sheet (s)</dt>
473
- <dd>Navigate to a different sheet in the current workbook. You may choose
474
- between a sheet-number and the name of a sheet. If you want to indicate
475
- the next sheet <strong>by name</strong>, the list of all available names is first
476
- shown. You just type right away the one that you want.</dd>
182
+ <dd>Navigate to a different sheet whthin the current workbook. You can choose
183
+ a sheet by its number or by its name. If you want to select the next sheet
184
+ <strong>by name</strong>, a list of available names will first be shown. You just type
185
+ the name you want.</dd>
477
186
  <dt>column (c)</dt>
478
- <dd>Alter the properties of the table-columns. At the time of this writing
479
- (February 2017) the only property that can be changed, is the width of all
480
- columns. When you enter &quot;<strong>c</strong>&quot; the subcommand column width (w) is shown.
481
- After entering &quot;<strong>w</strong>&quot; you can enter the desired width in characters.</dd>
187
+ <dd>Alter the properties of the table columns. As of February 2017 the only
188
+ property that can be changed, is the width of all columns. When you enter
189
+ &quot;<strong>c</strong>&quot; the subcommand column width (w) is shown. After entering &quot;<strong>w</strong>&quot;
190
+ you can enter the desired width in characters.</dd>
482
191
  <dt>Arrows(i, j, k, l)</dt>
483
- <dd>Navigate in a sheet that is too big to be displayed entirely at once.
484
- These hotkeys correspond to the default navigation keys in the vi editor.</dd>
192
+ <dd>Use these hotkeys to navigate a sheet that is too big to be displayed
193
+ entirely at once. These hotkeys correspond to the default navigation keys
194
+ in the Vi editor.</dd>
485
195
  <dt>quit (q)</dt>
486
196
  <dd>Enter &quot;<strong>q</strong>&quot; to quit the program at any moment except when an input
487
197
  invitation is shown.</dd>
@@ -489,9 +199,9 @@ invitation is shown.</dd>
489
199
  </blockquote>
490
200
  </div>
491
201
  <div class="section" id="hidden-menu-commands">
492
- <h2>Hidden (menu-)commands</h2>
493
- <p>There is currently only one such command available:
494
- The <strong>Escape-key</strong> will interrupt an unfinished action and refresh the display.</p>
202
+ <h2>Hidden menu commands</h2>
203
+ <p>Currently, there is only one such command available. Pressing the <strong>Escape
204
+ key</strong> will interrupt an unfinished action and refresh the display.</p>
495
205
  </div>
496
206
  </div>
497
207
  <div class="section" id="other-information">
@@ -499,18 +209,18 @@ The <strong>Escape-key</strong> will interrupt an unfinished action and refresh
499
209
  <blockquote>
500
210
  <dl class="docutils">
501
211
  <dt>Development and source code</dt>
502
- <dd>Viewworkbook has been written in Ruby. As Ruby is an interpreted programming
503
- language, the executable file and all those that it may refer to at one
504
- point in time, are themselves the source-files of the current
505
- program-version. You can open them in any text-editor to scrutinize the
506
- source-code. If you have received the program as a Ruby-gem, you can also
507
- decompress a copy of the gem-file with <strong>tar -x</strong>, then <strong>tar -xzf</strong>.</dd>
212
+ <dd>Viewworkbook has been written in Ruby. Since Ruby is an interpreted programming
213
+ language, the executable file and all files to which it refers at any given time
214
+ are the source files of the current program version. You can open these
215
+ files in any text editor to examine the source code. If you have received
216
+ the program as a Ruby-gem, you can also decompress a copy of the gem-file
217
+ with <strong>tar -x</strong>, then <strong>tar -xzf</strong>.</dd>
508
218
  <dt>Bugs</dt>
509
- <dd>Negative values are not always displayed, when very long (like 15 ciphers).
510
- Enlarging the column-width further does not have an effect.</dd>
219
+ <dd>Negative values are not always displayed, when they are very long (like 15
220
+ ciphers). Increasing the column width further does not help.</dd>
511
221
  <dt>License</dt>
512
- <dd>Viewworkbook is distributed under the conditions of the GNU General Public
513
- License, version 3.</dd>
222
+ <dd>Viewworkbook is distributed under the conditions of the WTFPL 2.0 or later,
223
+ see <a class="reference external" href="http://www.wtfpl.net/about/">http://www.wtfpl.net/about/</a> for details</dd>
514
224
  <dt>Author</dt>
515
225
  <dd>Viewworkbook has been developed by Michael Uplawski
516
226
  &lt;<a class="reference external" href="mailto:michael.uplawski&#64;uplawski.eu">michael.uplawski&#64;uplawski.eu</a>&gt;</dd>
Binary file