GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing github.com — fix: #266 miscellaneous doc updates · python-openxml/python-docx@e24c77d

File tree

Expand file treeCollapse file tree

Open diff view settings

Filter options

docs
- index.rst
- user
  - quickstart.rst
docx/styles
- styles.py

Expand file treeCollapse file tree

Open diff view settings

Collapse file

`‎docs/index.rst‎`

Copy file name to clipboardExpand all lines: docs/index.rst

+10-4Lines changed: 10 additions & 4 deletions

Display the source diff
Display the rich diff

Original file line number	Diff line number	Diff line change
`@@ -42,16 +42,22 @@ Here's an example of what \|docx\| can do:`
`42`	`42`
`43`	`43`	`document.add_picture('monty-truth.png', width=Inches(1.25))`
`44`	`44`
	`45`	`+ records = (`
	`46`	`+ (3, '101', 'Spam'),`
	`47`	`+ (7, '422', 'Eggs'),`
	`48`	`+ (4, '631', 'Spam, spam, eggs, and spam')`
	`49`	`+ )`
	`50`	`+`
`45`	`51`	`table = document.add_table(rows=1, cols=3)`
`46`	`52`	`hdr_cells = table.rows[0].cells`
`47`	`53`	`hdr_cells[0].text = 'Qty'`
`48`	`54`	`hdr_cells[1].text = 'Id'`
`49`	`55`	`hdr_cells[2].text = 'Desc'`
`50`		`- for item in recordset:`
	`56`	`+ for qty, id, desc in records:`
`51`	`57`	`row_cells = table.add_row().cells`
`52`		`- row_cells[0].text = str(item.qty)`
`53`		`- row_cells[1].text = str(item.id)`
`54`		`- row_cells[2].text = item.desc`
	`58`	`+ row_cells[0].text = str(qty)`
	`59`	`+ row_cells[1].text = id`
	`60`	`+ row_cells[2].text = desc`
`55`	`61`
`56`	`62`	`document.add_page_break()`
`57`	`63`

Collapse file

`‎docs/user/quickstart.rst‎`

Copy file name to clipboardExpand all lines: docs/user/quickstart.rst

+13-16Lines changed: 13 additions & 16 deletions

Display the source diff
Display the rich diff

Original file line number	Diff line number	Diff line change
`@@ -115,9 +115,9 @@ supports indexed access, like a list::`
`115`	`115`	`row.cells[0].text = 'Foo bar to you.'`
`116`	`116`	`row.cells[1].text = 'And a hearty foo bar to you too sir!'`
`117`	`117`
`118`		-The ``.rows`` and ``.columns`` collections on a table are iterable, so you can
`119`		-use them directly in a ``for`` loop. Same with the ``.cells`` sequences on
`120`		`-a row or column::`
	`118`	+The ``.rows`` and ``.columns`` collections on a table are iterable, so you
	`119`	+can use them directly in a ``for`` loop. Same with the ``.cells`` sequences
	`120`	`+on a row or column::`
`121`	`121`
`122`	`122`	`for row in table.rows:`
`123`	`123`	`for cell in row.cells:`
`@@ -137,7 +137,11 @@ This can be very handy for the variable length table scenario we mentioned`
`137`	`137`	`above::`
`138`	`138`
`139`	`139`	`# get table data -------------`
`140`		`- items = get_things_from_database_or_something()`
	`140`	`+ items = (`
	`141`	`+ (7, '1024', 'Plush kittens'),`
	`142`	`+ (3, '2042', 'Furbees'),`
	`143`	`+ (1, '1288', 'French Poodle Collars, Deluxe'),`
	`144`	`+ )`
`141`	`145`
`142`	`146`	`# add table ------------------`
`143`	`147`	`table = document.add_table(1, 3)`
`@@ -229,14 +233,11 @@ thing. You can also apply a style afterward. These two lines are equivalent to`
`229`	`233`	`the one above::`
`230`	`234`
`231`	`235`	`paragraph = document.add_paragraph('Lorem ipsum dolor sit amet.')`
`232`		`- paragraph.style = 'ListBullet'`
	`236`	`+ paragraph.style = 'List Bullet'`
`233`	`237`
`234`		`-The style is specified using its style ID, 'ListBullet' in this example.`
`235`		`-Generally, the style ID is formed by removing the spaces in the style name as`
`236`		`-it appears in the Word user interface (UI). So the style 'List Number 3'`
`237`		-would be specified as ``'ListNumber3'``. However, note that if you are using
`238`		`-a localized version of Word, the style ID may be derived from the English`
`239`		`-style name and may not correspond so neatly to its style name in the Word UI.`
	`238`	`+The style is specified using its style name, 'List Bullet' in this example.`
	`239`	`+Generally, the style name is exactly as it appears in the Word user interface`
	`240`	`+(UI).`
`240`	`241`
`241`	`242`
`242`	`243`	`Applying bold and italic`
`@@ -324,8 +325,4 @@ the same result as the lines above::`
`324`	`325`	`run = paragraph.add_run('text with emphasis.')`
`325`	`326`	`run.style = 'Emphasis'`
`326`	`327`
`327`		`-As with a paragraph style, the style ID is formed by removing the spaces in`
`328`		`-the name as it appears in the Word UI. So the style 'Subtle Emphasis' would`
`329`		-be specified as ``'SubtleEmphasis'``. Note that if you are using
`330`		`-a localized version of Word, the style ID may be derived from the English`
`331`		`-style name and may not correspond to its style name in the Word UI.`
	`328`	`+As with a paragraph style, the style name is as it appears in the Word UI.`

Collapse file

`‎docx/styles/styles.py‎`

Copy file name to clipboardExpand all lines: docx/styles/styles.py

+1-1Lines changed: 1 addition & 1 deletion

Original file line number	Diff line number	Diff line change
`@@ -51,7 +51,7 @@ def __getitem__(self, key):`
`51`	`51`	`'style lookup by style_id is deprecated. Use style name as '`
`52`	`52`	`'key instead.'`
`53`	`53`	`)`
`54`		`- warn(msg, UserWarning)`
	`54`	`+ warn(msg, UserWarning, stacklevel=2)`
`55`	`55`	`return StyleFactory(style_elm)`
`56`	`56`
`57`	`57`	`raise KeyError("no style with name '%s'" % key)`

0 commit comments

Comments

0 (0)

You are visitor 01402520 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.