18

I am using python-docx 0.7.6.

I can't seem to be able to figure out how to set font family and size for a certain paragraph.

There is .style property but style="Times New Roman" doesn't work.

Can somebody please point me to an example?

Thanks.

5 Answers 5

47

This is how to set the Normal style to font Arial and size 10pt.

from docx.shared import Pt

style = document.styles['Normal']
font = style.font
font.name = 'Arial'
font.size = Pt(10)

And this is how to apply it to a paragraph.

paragraph.style = document.styles['Normal']

Using the current version of python-docx (0.8.5).

17

After reading through the API documentation I was able to figure out how to create my own style and apply it. You could create a paragraph style object the same way by changing this code to use WD_STYLE_TYPE.PARAGRAPH. Something that took me a minute to figure out was the objects and at what level they are applied so just make sure you understand that clearly. Something I found counter intuitive is that you define the styles properties after its creation.

This is how I created a character level style object.

document = Document(path to word document)

# Creates a character level style Object ("CommentsStyle") then defines its parameters

obj_styles = document.styles
obj_charstyle = obj_styles.add_style('CommentsStyle', WD_STYLE_TYPE.CHARACTER)
obj_font = obj_charstyle.font
obj_font.size = Pt(10)
obj_font.name = 'Times New Roman'

This is how I applied the style to a run.

paragraph.add_run(any string variable, style = 'CommentsStyle').bold = True
3
  • 1
    Thanks! This is sorely missing from the official documentation. Other SO answers imply it isn't supported. Mar 21, 2019 at 17:16
  • 2
    @alex-nies I tried the same, but in your .add_style() line I get an error: NameError: name 'WD_STYLE_TYPE' is not defined ... any idea of why?
    – abu
    May 25, 2021 at 19:47
  • 4
    @abu from docx.enum.style import WD_STYLE_TYPE
    – akBeater
    Jun 3, 2022 at 11:22
3

Support for run styles has been added in latest version of python-docx

3

Use this code it will help u a lot.

import docx
from docx.shared import Pt
from docx.enum.style import WD_STYLE_TYPE

doc = docx.Document()

parag = doc.add_paragraph("Hello!")

font_styles = doc.styles
font_charstyle = font_styles.add_style('CommentsStyle', WD_STYLE_TYPE.CHARACTER)
font_object = font_charstyle.font
font_object.size = Pt(20)
font_object.name = 'Times New Roman'

parag.add_run("this word document, was created using Times New Roman", style='CommentsStyle').bold = True
parag.add_run("Python", style='CommentsStyle').italic = True
doc.save("test.docx")
1
0

The documentation for python-docx is here: http://python-docx.readthedocs.org/en/latest/

The styles that are available in the default template are listed here: http://python-docx.readthedocs.org/en/latest/user/styles.html

In your example above you used a typeface name ("Times New Roman") instead of a style id. If you use "Heading1" for example, that would change the look of the font, among other things, since it's a paragraph style.

At present there is no API for directly applying a typeface name or font size to text in python-docx, although that and more is coming in the next release, probably within a month. In the meantime, you can define styles for the paragraph and character settings you want and apply those styles. Using styles is the recommended way to apply formatting in Word, similar to how CSS is the recommended way to apply formatting to HTML.

7
  • "In the meantime, you can define styles for the paragraph and character settings you want and apply those styles." Any example of tutorial for this? This is possible with the API right? Jan 11, 2015 at 15:37
  • Using styles might be recommended way. But lets say I have 10 paragraphs with each some slight style change. It doesn't really make sense creating 10 styles to apply them. In word, you can always select a paragraph and apply some style changes only to that paragraph. Jan 11, 2015 at 15:40
  • We are migrating from PHP (PHPDocx) to Python. PHPDocx is way more advanced, hence the expectations. Jan 11, 2015 at 15:41
  • "In the meantime, you can define styles for the paragraph and character settings you want and apply those styles." Any example of tutorial for this? This is possible with the API right? "From the documentation doesn't seem like it." Jan 11, 2015 at 15:43
  • If you're just changing formatting at the in-line level, like a phrase in a different font or something, you can do that with character styles. Those are applied at the run level. If you really do have that many different paragraph styles I'd be interested to hear more about your use case. It would be unusual in my experience to have ten out of paragraphs each having unique paragraph formatting, but I'm always open to new experiences :)
    – scanny
    Jan 12, 2015 at 7:56

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.