From 0274a3bc3b1a479c766915a562db6fb19ef97daa Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Thu, 8 Dec 2022 09:34:52 -0800 Subject: [PATCH] Use sphinxext-opengraph to generate OpenGraph metadata (GH-99931) (cherry picked from commit f49c735e525cf031ddbfc19161aafac4fb18837b) Co-authored-by: Hugo van Kemenade Co-authored-by: C.A.M. Gerlach --- Doc/_static/og-image.png | Bin 0 -> 14572 bytes Doc/conf.py | 34 +++++++++++++++--- Doc/requirements.txt | 1 + ...2-12-02-17-08-08.gh-issue-99931.wC46hE.rst | 2 ++ 4 files changed, 33 insertions(+), 4 deletions(-) create mode 100644 Doc/_static/og-image.png create mode 100644 Misc/NEWS.d/next/Documentation/2022-12-02-17-08-08.gh-issue-99931.wC46hE.rst diff --git a/Doc/_static/og-image.png b/Doc/_static/og-image.png new file mode 100644 index 0000000000000000000000000000000000000000..0e80751e740387f9305718537f4b26b32e774088 GIT binary patch literal 14572 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

e6!LR zcp8oaD<#HR=D=2@-0{dXO>Zl<5it`G>W@|;U7XD;6-aF5zWQhUl|Fd~lr-iMB}KqV`sl$juygCTVLRNv=;Ju1Gv)6 zv3j>;^ZJ$3fPz`^3gUmyP4lcXfte+fAPOPRM6z^$H4ACYCaEqkY9PT{w8y5m%hm2` zYxcCt0CgB-E$r=<$<@*p?>kPxc~%31AC&o?M*yB7#R z%K!RHn>?qO9}HlSCPw0-7gm%lb`(xClANoCX7dpT+=%di!JZjhZP5h{{LNn{o|ptX zG@mSs?W$oYeAjTI1%j7`YiEm~%I`X9YIjW@WV*F+<3D`aS9L%s6<BP6IcAtLA=PwO+QgHe$Rol>&?k-HU-_o~6hvOvy} zL>vAs0`91Pl1itct4RoA+qPEa?o}IW!xjOg)AEraUWCD8o>%td-bHUHRIuQNa3S|a zpv4EjptqiA$Tpp`SO9*Oz+02v!dSX%_RTs01NKfdpdo}VFyujabu#&trfVss4stS3 zryf?oI`Q~V9AqO4Jn!5&~utjOR zW2|@%z8vE255-mL>F6@R17~+0>hp)3d0>r$;SiVn{dG)F70UFa`Y>LCh`NYDth!7U!ibZH2s2WJm@X>G(b9@oO`y3pC|&?)@hG->7?vVd*(c`$Pij+B$@%Usn|k0 zV-V2sO~g{y9b%A?A`HNUSwH}A>y$ef{~V1~(#q0OfrEn)1Znzehjz=e^kB*^it%07 zLfBBg2yblp{p7-EqNBVg2rj$BfW9bM>C~g6_(YuYH{U>naAE+I5*mR>(2_XCy3^?P zli=qBJ7ddo)0>YSE(j6_L?2}kUM2O^SjC!**t!;66RBH*B*MNRpLf8Sux-SoufJ&( zP_RFN4sbGd+Wi3X$EHG+ZU7$gG5UZLZlooDW*5uav#qn|aD&R7#ox=uspMSoLhncX zH8Z4Amj+iVJ0WviBuP~3MS(wMgDwzKsKX1Ws_O!^sl5$N#zO4?lq+cyfP5e<)DQ^p zGxEbn*pPti#6yIsM=qfrqTDy3Vq%C>k4`2x92x*_?B_~pA96{pT+)Q)HLk!6BS;Bp zbS91mVQ18Y2bq``nyiR)o%ajJVMCQ2*ZED>v1_Q|mIXjrfMw+bfy*6dbv1FI6#rab zbP56eu{$TYlaHhmXdr^q*$zp=I>%uD2&F)z<=$q6fnWd%6bqaXcVH`e3@_vykGlgo zSP!w6dFEmNre-8lqpA6X3*CzwynIf82_=($eaRFbnKTIAKgmZH@c%yu{t|tmW>s`6 UV!@y#1-x!D9~C4k#SMb~2O(Bf#{d8T literal 0 Hc-jL100001 diff --git a/Doc/conf.py b/Doc/conf.py index fd4ee2d5eee8..98b076c0ee57 100644 --- a/Doc/conf.py +++ b/Doc/conf.py @@ -13,9 +13,25 @@ sys.path.append(os.path.abspath('includes')) # General configuration # --------------------- -extensions = ['sphinx.ext.coverage', 'sphinx.ext.doctest', - 'pyspecific', 'c_annotations', 'escape4chm', - 'asdl_highlight', 'peg_highlight', 'glossary_search'] +extensions = [ + 'asdl_highlight', + 'c_annotations', + 'escape4chm', + 'glossary_search', + 'peg_highlight', + 'pyspecific', + 'sphinx.ext.coverage', + 'sphinx.ext.doctest', +] + +# Skip if downstream redistributors haven't installed it +try: + import sphinxext.opengraph +except ImportError: + pass +else: + extensions.append('sphinxext.opengraph') + doctest_global_setup = ''' try: @@ -109,7 +125,7 @@ html_additional_pages = { html_use_opensearch = 'https://docs.python.org/' + version # Additional static files. -html_static_path = ['tools/static'] +html_static_path = ['_static', 'tools/static'] # Output file base name for HTML help builder. htmlhelp_basename = 'python' + release.replace('.', '') @@ -234,3 +250,13 @@ linkcheck_ignore = [r'https://bugs.python.org/(issue)?\d+'] # Relative filename of the data files refcount_file = 'data/refcounts.dat' stable_abi_file = 'data/stable_abi.dat' + +# sphinxext-opengraph config +ogp_site_url = 'https://docs.python.org/3/' +ogp_site_name = 'Python documentation' +ogp_image = '_static/og-image.png' +ogp_custom_meta_tags = [ + '', + '', + '', +] diff --git a/Doc/requirements.txt b/Doc/requirements.txt index 958665db69e2..134f39d6d7b3 100644 --- a/Doc/requirements.txt +++ b/Doc/requirements.txt @@ -8,6 +8,7 @@ sphinx==4.5.0 blurb sphinx-lint==0.6.7 +sphinxext-opengraph>=0.7.1 # The theme used by the documentation is stored separately, so we need # to install that as well. diff --git a/Misc/NEWS.d/next/Documentation/2022-12-02-17-08-08.gh-issue-99931.wC46hE.rst b/Misc/NEWS.d/next/Documentation/2022-12-02-17-08-08.gh-issue-99931.wC46hE.rst new file mode 100644 index 000000000000..0c01a2cb2cfa --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2022-12-02-17-08-08.gh-issue-99931.wC46hE.rst @@ -0,0 +1,2 @@ +Use `sphinxext-opengraph `__ +to generate `OpenGraph metadata `__. -- 2.47.3