khA d Z ddlmZ ddlmZmZmZ ddl m
Z
m Z ddl m
Z
ddlmZmZ ddlmZ ddlmZ dd lmZ dd
lmZ d d lmZ d*d
Zd+de fdZ d Z d,de fdZ d Z!d-de fdZ"d.de fdZ#de$fdZ%de$fdZ&d Z'd Z( G d d e Z) ed e) d/d!Z*d"e fd#Z+d$efd%Z,d$ede$fd&Z-d$efd'Z.d0d$ed(e/fd)Z0y # e$ r
ddlmZmZmZ Y w xY w)1z0docx operation methods based on ``python-docx``. )Pt) OxmlElement parse_xmlregister_element_cls)qnnsdecls)
CT_Picture)BaseOxmlElement
OneAndOnlyOne)WD_COLOR_INDEX)UnrecognizedImageError)_Cell)RELATIONSHIP_TYPE ) rgb_valuec | j j d d }|j t d t | |j t d t t d|z y)a Set section column count and space. All the columns have same width.
Args:
section : ``python-docx`` Section instance.
num (int): Column count. Defaults to 2.
space (int, optional): Space between adjacent columns. Unit: Pt. Defaults to 0.
./w:colsr w:numw:space N)_sectPrxpathsetr strint)sectionnumspacecols P/var/www/teggl/fontify/venv/lib/python3.12/site-packages/pdf2docx/common/docx.pyset_equal_columnsr! sR //
+A
.CGGBwKS"GGByM3s2e8}-.
width_listc
P | j j d d }t | dk( r t | dk7 r|j y|j |j t d t
t | |j t d d |D ]~ }t d }|j t d t
t d
|z |j t d t
t d
|z |j | y) a Set section column count and space.
Args:
section : ``python-docx`` Section instance.
width_list (list|tuple): Width of each column.
space (int, optional): Space between adjacent columns. Unit: Pt. Defaults to 0.
Scheme::
r r r Nr z w:equalWidth0zw:colw:wr r )
r r lenclearr r r r r append)r r# r colswes r set_columnsr- $ s ?? ,Q /D : t9a< JJLHHR[#c*o./HHR
% biSAY ( bmSRX /0 A r" c v | j }|j j | dx| _ | _ y)zDelete a paragraph.
Reference:
https://github.com/python-openxml/python-docx/issues/33#issuecomment-77661907
N)_element getparentremove_p) paragraphps r delete_paragraphr5 H s2 AKKM(,,IL9%r" line_spacingc | j }||_ t d |_ t d |_ t d |_ t d |_ d|_ dj t d }| j j j dt | dj t d }| j j j dt | |S )a Reset paragraph format, especially line spacing.
Two kinds of line spacing, corresponding to the setting in MS Office Word:
* line_spacing=1.05: single or multiple
* line_spacing=Pt(1): exactly
Args:
p (Paragraph): ``python-docx`` paragraph instance.
line_spacing (float, optional): Line spacing. Defaults to 1.05.
Returns:
paragraph_format: Paragraph format.
r Tz r+ z )paragraph_formatr6 r space_before space_after left_indent right_indent
widow_controlformatr r2 get_or_add_pPrinsertr )r4 r6 pfxmls r reset_paragraph_formatrC S s
B"BOeBOUBNUBNeBOB +
1
1'#,
?CDD IcN3
*
1
1'#,
?CDD IcN3
Ir" c t d }t d }t d }|j | |j | | j j | y)a Hide paragraph. This method just sets the paragraph property, while the added text must
be hided explicitly.
r = p.add_run()
r.text = "Hidden"
r.font.hidden = True
Args:
p (Paragraph): python-docx created paragraph.
zw:pPrw:rPrzw:vanishN)r r) r2 )r4 pPrrPrvs r set_hidden_propertyrI t sH g
C
g
CJ AJJqMJJsODDKKr" scalec
| j j j dt dj t d d|z y)a Set character spacing: scaling.
Manual operation in MS Word: Font | Advanced | Character Spacing | Scaling.
Args:
p_run (docx.text.run.Run): Proxy object wrapping element.
scale (float, optional): scaling factor. Defaults to 1.0.
r zr+ d N_rget_or_add_rPrr@ r r> r )p_runrJ s r set_char_scalingrQ s@
HH $$Q)00 s5yIJLr" r c
| j j j dt dj t d d|z y)a1 Set character spacing.
Manual operation in MS Word: Font | Advanced | Character Spacing | Spacing.
Args:
p_run (docx.text.run.Run): Proxy object wrapping element.
space (float, optional): Spacing value in Pt. Expand if positive else condense. Defaults to 0.0.
r zr+ r NrM )rP r s r set_char_spacingrS s@
HH $$Q/66ws|RXNOQr" srgbc
< t d t j t d t j t d t j t d t j
t d t j t d t j i}||v r|| | j _ yt | dd j d }d
j t d | }| j j j! d t# | y)
a Set character shading color, in case the color is out of highlight color scope.
Reference:
http://officeopenxml.com/WPtextShading.php
Args:
p_run (docx.text.run.Run): Proxy object wrapping element.
srgb (int): Color value.
)r r r )r r r )r r r )r r r )r r r )r r r N z4r+ r )r r RED BRIGHT_GREENBLUEYELLOWPINK TURQUOISEfonthighlight_colorhexzfillr> r rN rO r@ r )rP rT color_mapcrB s r set_char_shadingrd s 'N . .'N 7 7'N / /'N 1 1'N / /'N 4 4
I y%.t_
"
IabM "ELLWUX\[\]
!((IcN;r" c t | dd j d }dj t d | }| j j j
dt | y)zSet underline and color.
Args:
p_run (docx.text.run.Run): Proxy object wrapping element.
srgb (int): Color value.
rV NrW z%r+ r )r` ra r> r rN rO r@ r )rP rT rc rB s r set_char_underlinerf sU D !"
A A
2
9
9'#,
JC HH $$Q #7r" c & | j }|j |t j d }t d }|j t
d | |j t
d d t d }t d }t d }|j t
d
d |j | |j | ||_ |j | | j } | j j | | S ) a Create a hyperlink within a paragraph object.
Reference:
https://github.com/python-openxml/python-docx/issues/74#issuecomment-215678765
Args:
paragraph (Paragraph): ``python-docx`` paragraph adding the hyperlink to.
url (str): The required url.
text (str): The text displayed for the url.
Returns:
Run: A Run object containing the hyperlink.
T) is_externalz w:hyperlinkzr:idz w:history1zw:rrE zw:rStylew:val Hyperlink) part relate_tor HYPERLINKr r r r) textadd_runrN )
r3 urlro rl r_id hyperlinknew_runrG rStylers
r
add_hyperlinkrw s " >>D >># 0 : :> MD M*I
MM"V*d%
MM"[/3' % G g
C
$F
JJr'{K( JJv NN3GL
W ADDKK Hr" c | j } |j |t | t | d| j
_ y# t $ r t d Y yw xY w)z Add image to paragraph.
Args:
p (Paragraph): ``python-docx`` paragraph instance.
image_path_or_stream (str, bytes): Image path or stream.
width (float): Image width in Pt.
height (float): Image height in Pt.
)widthheightzUnrecognized Image.N ?)rp add_picturer r
printr8 r6 )r4 image_path_or_streamry rz docx_spans r add_imager s_ I 2"U)BvJ W '+A# "
#$s &A
A! A!c p e Zd ZdZ ed Z ed Z ed Zed Z ed Z
ed Z y)
_CT_AnchorzA
```` element, container for a floating image.
z wp:extentzwp:docPrz a:graphicc J t | j || }||j _ ||j _ ||j
_ d|z |j
_ d|j j _
|j j j | |S )zn
Return a new ```` element populated with the values passed
as parameters.
z
Picture %dz8http://schemas.openxmlformats.org/drawingml/2006/picture) r _anchor_xmlextentcxcydocPridnamegraphic graphicDatauri _insert_pic)clsr r shape_idpicpos_xpos_yanchors r newz_CT_Anchor.new s 3??5%89
" (8 3 F ""& ""..s3
r" c d}t j ||||| } | j |||| || }
|
j j j | |
S )z}
Return a new `wp:anchor` element containing the `pic:pic` element
specified by the argument values.
r )r r r r r ) r r rIdfilenamer r r r pic_idr r s r new_pic_anchorz_CT_Anchor.new_pic_anchor/ sT nnVXsB;R3u=""..s3
r" c N dt dddd t | t | fz S )Na
%d
%d
wpar rv )r r )r r r s r r z_CT_Anchor._anchor_xml; s1
& 'tS% =s5z3u: W'
X
r" N) __name__
__module__ __qualname____doc__r r r r classmethodr r r r" r r r sa ;
'F * %EK(G
r" r z wp:anchorNc p | j }|j j | \ }}|j t | d \ }} |j j
|j } }
t j |
|| || t | t | } |j j | y)a Add float image behind text.
Args:
p (Paragraph): ``python-docx`` Paragraph object this picture belongs to.
image_path_or_stream (str, bytes): Image path or stream.
width (float): Displaying width of picture, in unit Pt.
pos_x (float): X-position (English Metric Units) to the top-left point of page valid region
pos_y (float): Y-position (English Metric Units) to the top-left point of page valid region
N) rp rl get_or_add_imagescaled_dimensionsr next_idr r r rN add_drawing)
r4 r~ ry r r runr imager r r r r s
r add_float_imager W s ))+C**+?@JC
$
$RY
5FB ))5>>hH
&
&xhB5 SUV[S\
]FFFv r" indentc | j j d }|rbt d }|j t d t d|z |j t d d |d j
| yy) zIndent a table.
Args:
table (Table): ``python-docx`` Table object.
indent (float): Indent value, the basic unit is 1/20 pt.
zw:tblPrzw:tblIndr& r w:typedxar N)r/ r r r r r r) )tabler tbl_prr, s r indent_tabler m sh ^^
!
!)
,F
# biRY ( blE"q r" cellc ~ | j }|j }t d }dD ] }||v st dj | }|j t d t
|j | |j t d d |j | |j | y)a Set cell margins. Provided values are in twentieths of a point (1/1440 of an inch).
Reference:
* https://blog.csdn.net/weixin_44312186/article/details/104944773
* http://officeopenxml.com/WPtableCellMargins.php
Args:
cell (_Cell): ``python-docx`` Cell instance you want to modify.
kwargs (dict): Dict with keys: top, bottom, start, end.
Usage::
set_cell_margins(cell, top=50, start=50, bottom=50, end=50)
zw:tcMar)topstartbottomendw:{}r& r r N) _tcget_or_add_tcPrr r> r r r getr) )r kwargstctcPrtcMarmnodes r set_cell_marginsr | s
B
D "E
. ; v}}Q /0D HHRYFJJqM 2 3 HHR\5 ) LL KKr" c t | dd j d }| j j j t dj
t d | y)a Set cell background-color.
Reference:
https://stackoverflow.com/questions/26752856/python-docx-set-table-cell-background-and-text-color
Args:
cell (_Cell): ``python-docx`` Cell instance you want to modify
srgb (int): RGB color value.
rV NrW zr+ )r` ra r r r) r r> r )r rT rc s r set_cell_shadingr sT D !"
A AHH %%i0J0Q0QRYZ]R^`a0b&cdr" c | j }|j }|j d }| t d }|j | dD ] }|j | }|sdj
| }|j t | }| t | }|j | dD ]= } | |v s|j t dj
| t || ? y)a Set cell`s border.
Reference:
* https://stackoverflow.com/questions/33069697/how-to-setup-cell-borders-with-python-docx
* https://blog.csdn.net/weixin_44312186/article/details/104944110
Args:
cell (_Cell): ``python-docx`` Cell instance you want to modify.
kwargs (dict): Dict with keys: top, bottom, start, end.
Usage::
set_cell_border(
cell,
top={"sz": 12, "val": "single", "color": "#FF0000", "space": "0"},
bottom={"sz": 12, "color": "#00FF00", "val": "single"},
start={"sz": 24, "val": "dashed", "shadow": "true"},
end={"sz": 12, "val": "dashed"},
)
z w:tcBordersN)r r r r insideHinsideVr )szvalcolorr shadow) r r first_child_found_inr r) r r> findr r r )
r r r r tcBordersedge edge_datatagelementkeys
r set_cell_borderr s *
B
D ))-8I
. I H MJJt$ --%C nnRW-G%c* ) A
M)#KK6==#5 6IcN8KL
MMr" directionc | j }|j }t d }|j t d | |j | y)zSet vertical text direction for cell.
Reference:
https://stackoverflow.com/questions/47738013/how-to-rotate-text-in-table-cells
Args:
direction (str): Either "tbRl" (top to bottom) or "btLr" (bottom to top).
zw:textDirectionrj N)r r r r r r) )r r r r
textDirections r set_vertical_cell_directionr sF
B
D 12Mbk9-KK
r" )rV r )r )g?)r{ )g )NN)btLr)1r docx.sharedr docx.oxmlr r r ImportErrordocx.oxml.parser docx.oxml.nsr r docx.oxml.shaper docx.oxml.xmlchemyr
r docx.enum.textr docx.image.exceptionsr
docx.tabler docx.opc.constantsr sharer r! listr- r5 floatrC rI rQ rS r rd rf rw r r r r r r r r r r r" r r s! 6 NFF % & = ) 8 0
/"D "H- 5 B,
L%
L
Q%
Q< << 83 8.
h+(<
<
| [* - , u % < e% ec e -M -M`
U
c
c NMMNs
B< <C
C