Trabajando con Listas – Módulo Python .docx

Requisito previo: trabajar con el módulo .docx

Los documentos de Word contienen texto con formato envuelto en tres niveles de objeto. Los objetos de ejecución de nivel más bajo, los objetos de párrafo de nivel medio y los objetos de documento de nivel más alto. Por lo tanto, no podemos trabajar con estos documentos usando editores de texto normales. Pero podemos manipular estos documentos de Word en python usando el módulo python-docx. El comando Pip para instalar este módulo es:

pip install python-docx

El módulo Python docx permite a los usuarios manipular documentos ya sea manipulando el existente o creando un nuevo documento vacío y manipulándolo. Es una herramienta poderosa ya que te ayuda a manipular el documento en gran medida. Hay dos tipos de listas:

• Lista ordenada
• Lista desordenada

Para agregar una lista ordenada/desordenada en un documento de Word, hay estilos disponibles en el método .add_paragraph() del objeto del documento.

Sintaxis: doc.add_paragraph(String s, estilo=Ninguno)

Parámetros:

• String s: es la string de datos que se agregará como un párrafo. Esta string puede contener el carácter de nueva línea ‘\n’, tabuladores ‘\t’ o un carácter de retorno de carro ‘\r’.
• Estilo: Se utiliza para establecer el estilo.

Lista ordenada

Los estilos para agregar una lista ordenada son:

Nota: cada punto de la lista se considera como un párrafo en una lista, por lo que debe agregar cada punto como un nuevo párrafo con el mismo nombre de estilo.

Ejemplo 1: Agregar una lista ordenada en el documento de Word.

# Import docx NOT python-docx
import docx
  
# Create an instance of a word document
doc = docx.Document()
  
# Add a Title to the document 
doc.add_heading('GeeksForGeeks', 0)
  
# Adding list of style name 'List Number'
doc.add_heading('Style: List Number', 3)
# Adding points to the list named 'List Number'
doc.add_paragraph('The first item in an ordered list.',
                  style='List Number')
  
doc.add_paragraph('The second item in an ordered list.', 
                  style='List Number')
  
doc.add_paragraph('The third item in an ordered list.', 
                  style='List Number')
  
# Adding list of style name 'List Number 2'
doc.add_heading('Style: List Number 2', 3)
# Adding points to the list named 'List Number 2'
doc.add_paragraph('The first item in an ordered list.',
                  style='List Number 2')
  
doc.add_paragraph('The second item in an ordered list.',
                  style='List Number 2')
  
doc.add_paragraph('The third item in an ordered list.', 
                  style='List Number 2')
  
# Adding list of style name 'List Number 3'
doc.add_heading('Style: List Number 3', 3)
# Adding points to the list named 'List Number 3'
doc.add_paragraph('The first item in an ordered list.',
                  style='List Number 3')
  
doc.add_paragraph('The second item in an ordered list.',
                  style='List Number 3')
  
doc.add_paragraph('The third item in an ordered list.',
                  style='List Number 3')
  
# Now save the document to a location 
doc.save('gfg.docx')

Producción:

Documento gfg.docx

Lista desordenada

Los estilos para agregar una lista desordenada son:

Nota: cada punto de la lista se considera como un párrafo en una lista, por lo que debe agregar cada punto como un nuevo párrafo con el mismo nombre de estilo.

Ejemplo 2: Agregar una lista desordenada en el documento de Word.

# Import docx NOT python-docx
import docx
  
# Create an instance of a word document
doc = docx.Document()
  
# Add a Title to the document 
doc.add_heading('GeeksForGeeks', 0)
  
# Adding list of style name 'List Bullet'
doc.add_heading('Style: List Bullet', 3)
# Adding points to the list named 'List Number'
doc.add_paragraph('The first item in an unordered list.', 
                  style='List Bullet')
  
doc.add_paragraph('The second item in an unordered list.',
                  style='List Bullet')
  
doc.add_paragraph('The third item in an unordered list.',
                  style='List Bullet')
  
# Adding list of style name 'List Bullet 2'
doc.add_heading('Style: List Bullet 2', 3)
# Adding points to the list named 'List Number'
doc.add_paragraph('The first item in an unordered list.',
                  style='List Bullet 2')
  
doc.add_paragraph('The second item in an unordered list.',
                  style='List Bullet 2')
  
doc.add_paragraph('The third item in an unordered list.', 
                  style='List Bullet 2')
  
# Adding list of style name 'List Bullet 3'
doc.add_heading('Style: List Bullet 3', 3)
# Adding points to the list named 'List Number'
doc.add_paragraph('The first item in an unordered list.',
                  style='List Bullet 3')
  
doc.add_paragraph('The second item in an unordered list.',
                  style='List Bullet 3')
  
doc.add_paragraph('The third item in an unordered list.',
                  style='List Bullet 3')
  
# Now save the document to a location 
doc.save('gfg.docx')

Producción:

Documento gfg.docx