From 57e8eaeb33e9a5a70f69130192bece66a6b6d070 Mon Sep 17 00:00:00 2001 From: Frank Anema <33519926+Conengmo@users.noreply.github.com> Date: Wed, 6 Sep 2023 13:17:10 +0200 Subject: [PATCH] Docs: folium logo (#1801) * Use transparent png logo * add logo to docs header * set logo height * set space between logo and header * logo text in header * Simpler index text, link to leaflet * typo --- README.rst | 3 ++- docs/_static/folium_logo.jpg | Bin 8740 -> 0 bytes docs/_static/folium_logo.png | Bin 0 -> 1658 bytes docs/conf.py | 7 +++++-- docs/index.rst | 20 +++++++++++--------- 5 files changed, 18 insertions(+), 12 deletions(-) delete mode 100644 docs/_static/folium_logo.jpg create mode 100644 docs/_static/folium_logo.png diff --git a/README.rst b/README.rst index 43332966f..f2f6a6b4f 100644 --- a/README.rst +++ b/README.rst @@ -22,7 +22,8 @@ folium ====== -.. image:: https://github.com/python-visualization/folium/blob/main/docs/_static/folium_logo.jpg +.. image:: https://github.com/python-visualization/folium/blob/main/docs/_static/folium_logo.png + :height: 100px Python Data, Leaflet.js Maps diff --git a/docs/_static/folium_logo.jpg b/docs/_static/folium_logo.jpg deleted file mode 100644 index 3875c7b6b7b0d0ae5af2072ab9d41fe7050903a0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8740 zcmb_>2~-o=)@~sxD)vQ0K?ce1h$0#h6=)-MTUzNB+q5Dwh(<(+fEo~$AcSfMKn0{7 z5mC}gBO+pCmKG_65M+>u%mIlB0?L>GDMBh$^&k7**Z02l-dgWpcfEqesYPno`|Q2H z{e3%B8}$*Ivwho-+aMiq*yz|m5G8|t*~$$JfS{j#f~+A3ngLDInG5NHGac{)>6k&& z{yc}E?K5jx;lo?6hj?dLmf&8(ZD85`^Pn3&HZ}lOwpY> zZMxo!nX~l41%-2N-pn>H0}gbojU4ox+jHg}Qjchik_`RXkWowx4n)%!D+ zY{`8+e|LjosokLy=Vs0_Hd$b5wrsi8ij~&uH*Boqte)w^_+aCA59-dy_ zeuw=7*hd0`!cLw#9nOt7bN)h1Y~005m#p5DICU;34!W8*4pLOrSZ>X#0r`?T zz*lG){Ho|p&&QTuuOTZNqH;o!qK(06mJKSpI^_sysWkgSLG1(bO`Fj17q(bw#GJz^ z{^ymf1zNv!S&T)}vg#ACs#QpCAR8&@VuY*@yQ>Z(I27bzbyKb`Cf9Wy@VXsBen*_G zn2hlmBTcMjaA9;7k#Z|C>J(Q*OW?M5v%gVWRfN>rUF0Dfs=^T8!#-_VI)*lfPVO~X zPeCy|*0`to=26fi-+XURF;?@lrq!xhp>1Ba(oOq;xC4L8bnA@zK3`!qr1vy{W=^D& zhP+^W11xu?pc!3pf?zYL*0t2=<9wbAzEu<-NI^#Cwah$3P%u^{k;8qN4T3L;@~6hA z3Htz}k2QeAIx;amO{JWMh5s#tg0x$tf(oZ{f12`A2xqqIMXrlcTAS%~KetU_hBo? zw7;nji3xbe`*DLI3Ie}_`oa8ho-LYJDp>BrxhCiIjLcreJRkMFcvNhdO+mrx40#;p zVRhNE`XDT~rJyV?OW%vhT3@fZl_4W>sM3HNKL4z2S{3kT?- zt;S0GOAAWbmMxlk`-_|7G%xSsjJzaG1#$D&Kb_fG{p`j{f4F`9qk{@`s3BcNvN*BW zwNpM>QD+)X!G=N6QyRu2IYmJpe8mkSOvr zmPx}QD#y*41zFYG=UdS}A+y35#>{i_x++_ND$0_E>v!zMPGz5n3~EoDg}k`GGsi2; zJ$nZJ>}E+x#*wTI_{bVs|k~9lf}tq2NFSvtUfq6iWD4G&Pz5<*Q_d+&IuEwA9wwQf_y-M?^Ng-sszWb zBEd3;IC5EI`=K!dHU-U!*sH&}n`MH?*C?Mx#)u+|DCpAPS{xY7;AavVFFYA}rY>W0oRm z+>P~RCi!R@G!Ob&=kI?mddXV0`Z{=Tyi9P(X%PkaA?41X=qE5(yB#h-@}gUb9Kn|} zH0=eaiYy-g4cUl$Xd{@tlTOTGt@vBGih(GD$^T+sxVulz2Q}Y7f{Z#yLFFcx0JCaE zi`1#hWztDgPy@Xbv{zG%p{?*I)Ap zW})80viE!fr?3XVX zrWGm?NYQ8h$+O-}tYGb{wxeYe$TU>~&)^B+W*S?!79Dc1Ic{X)(k55j2#)S8-JD6! z&w9Jv?LukkafAui*jdEKKcfv8yQlD&65r@To6O{X?rpzCxHd1*!nJJq6|>A2-o}_k z(w%$WSCJi2;mWO8jQ{<>ci&)Vq!_Qa) z)edV66nnP{9Y;(<*TCP1?y)0cE0xe-Q+hW;S=FqEXl*Ms2q}2J@=TjI9yY(qwf$g*lpow1%FXlY_Nds zbK|Twm%RK^qb)A3TIt;>J~onti~R2eM4-83gOKp+CmY+yJ_Fb59g%RLcGjMfl9xA} zoPtl_MK4elsLQGOL{_x*hpx70keS9qXkn?#??m>gs(Z3p1NHZ1QWGJamh^!eTv6*M zKscUH@7xW3PeJ~ZkyonI5nI72B&3>D`IX zii1xE6W_v3|JEg)SVTVZNkT3~I{5%eMq;wneP0L)T5(k_CffL#F^BaeqS=j9U+Na% zMTja_)~(*9pe4bwxn%SE4ZKz4T#l|fbr4o0tDT3WZBoUrh#xO+;O`W4i732RFUUar zgC=bI5v9#7gJK?k(4*|wlP8b0KPhU7Go(_Ml~uU?088Q+o-1ld$RPjrF&Ev76+CX#hzty?RZr+} z9!A!t?Lm+QH90VQ@Ak~$&WOnfEABI89{^xrb4~MjqQ^gM9+E09a?wHfpEh6VU;&$_ zHTV3}=5=5A%Jo;i+B{Tr;MkMLHC%r=N24N&ud>^%H2368JtTmF1b6j_4DuNTJ(dm_ zv?}j{keY5Y&^iAmOgvNeAcRXC1VMU~elPHH^KOd{0 zsbei7Dkx~;3)hT1_nl6>+qwEMXE3 zI*w|yq7bnlV6Wg?>p*i+*?*BD+`r{4=(>3DrhBaIAil$XO%x>evY{Qv;Wj~3 zhnJVfsK6*{9e59#Yd07V_?cVjj~_>d=qiIGI3H=DsrC`RnplI&aJPvlU;!hJL3X|g zIhDszd!=6{-)dU1EBgmS3;b4wAN(I?TYf(?-iZOipo{Bzyk9R+KZWJNpu5J!lOHH( zakBROu|h!Fe%WF!E~TniSx}55RB_3ZfOUzU=dY>yZcHu`K00v~@7vsh)zm z_fe2&HCYxy!#LVxWOP@z1B+ajVCkFO*J(>WVYl-v`bfiUq`XxdpHIV_j))cLlu&dx z1$hU(&m`M{0f>8L7zO=7L2u*$mP1$6-{c(Iew;sIGE6!|O8B!|HInGM=%)W8>e_CR zbo3SlIScSMCUKhUtm*!|i-N2=Vkl_17yw%Me17Xz1fdPR`dDEYuXe_E%Pl98T!5NYX<5*C`DsK z@bXUJ56*Z1zkK1Mh&zkOrYT~R_*IZHy{zh$Eud&wf{W?3ob*!${v%;5KuQYF zr?trc#!%Xmi#e8|(~6P)0L@|PYYH+@MsTnz`)>3)NhNI4%vR9J1}CFSR5srqL5w8M z`f-{vV+#tJ1_vK!MW?@*EJL3#lbn7hGLT+Z3MxsWpb&R5jDV2dK??eCiGt7+HS3&o z4D9g-a|$|>c|~pT3Q>Ta3hLLCWrH0TpViu7G_|Xih0%uiY8OxoW$nj)Lxkrfqa7a2 zXklUGk#Vv5mP;r`E8rDP)D&JyL7!=VQrZ(+N#UD3o9jfV(kcP@3Xi%Z=q(;-i$E3G zzo7mrJf@reB0B6y!z`T>a_$21_4X(o<2NJuc_W-e!GbD{{gnQ=#!gD&K`mK1=Rv)4OkX;vU6^>y1qzcKldtce$S?$Ufq@lqq zUOv7L*TchQBf``ngtRK&`>bChz#a-_|B}wZmKFFD7i0~u@u^a~QO}H)r0_?%qnDdJaQH$1c2lqN(Lk=Bwch!8($aei_}cbE|>+Z1^$3Y5GO(h)}A&)EO>Z3EW@0UjR@b z9Opk2HCKchFVFF@H0pPlJQ2yD7iV44OssYgA?V{ryDE5l6KC$3xQ2CVg~Jt;AvC^*fmAv(mhvpce$0$D^|a; zuF#8B6mLdvg;QNcoPPW>*#`DAh9}zg<5WU3{VUE_q+<&~P8uymzbQ z1qGc#PU#KOt2Zr8>As0i_Rw}mzemTGQBWtyy64suKxWku}Rrq1qtLX6HUJtVvv1aG}us}8~nH?BvKk{^m zv}ZDO62uA5YwgG?St-AtCGkpb%AZ{UYQQws$Qs~&Zja}V(@w=j zRo%}D;Lw=tK|)ZNUA=9-wev*jMl+BSYt`Jy?ahuQi{8!%JF&%m*~p$7hjJEF4=juH z+F!sQW@-&7h@7*EF4^5tLCydzM~Ye9BeInGq}8_^?Q#l|9GId`jr6CWd1(TaG!&?} z6@U25|2+1V$nQY{U3(_4E<=`pL734PEdy=vxLgW4K|&be2SU(8B+5Lrev_!yIcYFy zc7IQMl9uggVx^Ii&rclWCK1^N&IAhsWNm!2ATI}`GmH2pI>TV$^PRB<6J1q!q{I)6 zWDcY?o`3!z1gNcSB%3%enm$}SbZlth)1>}8XtN#h_+Qg8U9cm8g6Z63xyfq-bFOo_ z83#iz79#3x6qH{uQsn8$OCPjc^KOGHI{tEZe~pN4Evo57q@9($5eN1}_Hw(CUNmC@ z3Jt#uyKv^Hjn1Cn4|Q3Kk!Jc}sbF9-z)K|>05t*hg z5}fAeBJs%DegoivawH~yc!MJKvYH(m0!zHQ*hGxV#-!yL7v`v(mQ|0f^K>2iXQ1kyFG~|41jhIsw$$vk{1_;79h>TivS_A+BRJQ zcqos8V05Ttn>~3}c^lEF_Fb2Nig;d-@pijlBIoUU*PU^d2j;(v`tdiZ))Hd{3ergb4ZV<~zR^|bQak$^ z1=Cy!&rmvf$!PH@d`vu-4etk;5iYlC%G09c;yx^z6)!)&8sv;?Y{>1qdOFA>&)GZo z0gKCf*{(z&#*##^HwVhsDy2rT=@-)((Niqz6P;K&GRI8#QCR)@Bhh5R4JFI_&OO$L z?{NLmoz=@DO+p>CFUC$!R+p-R$q*M_jJm-n0gJe@Z{q)j|7W zlj|jv7itOirZy?+=|yQ3-}#EYEa`7tKT-XdDO^|I_cIH^~L_k2qPpLUtMM@m#S;IY?Ihmp(7gnmkR%qKJ6O+LLf_n!Swya-q7oqN%mGm@$0EWiVU|M3l@#_+#{nApZR86&y4Rv-y+jd#kij8&|`KkLp=7kY``~K4MEQ+$VBe zK2s2A2YTeX@k#$$eOMe zH19#P3&CuiC?Vg({QKarhpnCGLC$RcjchTSoo1&vjI{F?oP5jo|3exXNxZ~5q*DXk z$Ub)^8poh#fLVx|Rgt`l9BpA1O{O*;e{i)L9xc9HHa`?LP&x&7yPTW!z{CsK@Gg+= zS7m7H*L+_>2l<{HlBov-k8fo}Vw9i)RmVl_KicX9;%V_XS<^9y=8f%)`d*>FsdXQJ zpjp$P+?g1??xVy~oD_)DpB^Nh^pW{v;<(W#FupBVXd3;~HNe_FwMSbEhMx)W?b_=_ zE8Vi-Pe$Y_>AC356m*|mWoZh?&c=LZ#Hu6Eg z8B?bX=W#3nX7(+rkGy%nmCYu(?xA{&hyUrBjs^RqaGl3 zUt@}%^H`cFqHz0x@dtgDUPVN;OKRZ$BavdQk(iv>Cud2zh3UeyrL=b1%#(n91@)Ia zLxE<9iAy|cgS_Fq;`gLH6~j{^vG{iCiJWxw31K@^r9F?}BM2 zX34wCb0HVAE+M;X?O^qJsU*VRa>Ylfx`O*4R$otUp#9#$Qs3?kEYr2iAs+)`>C@WY zoEcXk#-*R}ah|yJxcISKrW(q_j1%jLaQ&-UK z^1e;0knsErYq!9qWKF5*NAWjNn-wjoGJ_d`XuIXY_fGA^y-Z#nP^UoHanL`S*MPBz z$~C*=OH{`|2hiq77#++hcMZlYNrWGBb$@YiDIYeh;eKs>gHH3`kSLLSlR)h1071@7 z=?+T>$4`eQ*4bH;(sgyVxB1vze-3--Wg?Be<(~D=Kzcvl7n8R}|IIUoU4;W}u=DzA zO>5ILmbb`nb5g7A?Su*=vhnsIThBkz8cpJbdkJiDrd0uUax!q+oTOc>L%hER`G3yy zbtb)lXq^uP+^HjQVeEOU1g$9zV~ZBrvD=RqcXa`mfV6yV2IO8za}-A=*8hUEN1G^m znvl}M>qBJ$;~kHFKf%=I$OSPz%nB{@j=JGvnLCj$G8H!=@}*pkYVc3CSPR%9cT1vc z2X4c`j$m4#9g}IZ4akN&%IU1@htal@jjYSr_>)!Sdvxj0|&`$L(Ib}J4S;&6&g*q;q zIB(=i_+Ziw&!?w$#yBF^rOrtY5Ssd|@UF{waR|~sV&Dts!G-z!Cx=VWCZbIDvh_z; zwn$=LD_q%_Lm7cCXXS)RD3r`*O=UjYuA2)9*k`Z`z6b z6QJ5jDRSyD==2%=$sWb;CyQH)?MSkhMSnY*-agC43@PZ;d1bLg7CxhgG4oXk6Qj-g zgs{lk8WK(EMcm28I%SDy6Y;`9)N6VZ;iLpCr~`ayU2#6vB}&S_zw_n_FP)PM=ia-?y3H56=EPciJjJpfuw~pry&E$iR0x~2mm#_i>GYkAqGMzH~G4O zOb$4GoqI{l5CgfTjDdVg#|jy0h!wI}Au0g!fbsgc4nYqa)-|gXv#ewp$o&*Ckk7b` zvoCp847^X*CDW1HcK(nN)~yBflQud8OXVkVugGy44=JZks>Hx zsD!B=LhZ@@DSGa!Od$qBh$pW@48%YV5x^td;JT-38k|+tve`# zCB_>+Jsy#$i1dez1w3j>} zIzSq5wueOf+s@P}fL6%;6i!>ITOr2?v{y*BVzNCXTB2}#-8=+4EN%uGNN|>AAm@G) zV48;*NOK@jK+%$w?HM?p?jC{zSp3o_%^K4PACI;{41u>y)*)}y{TIvw+Jj-7*d82AocUrilF|MKT5iKfCiGh zm!$@jW>wVQ>IAYv20{ixDI2^_ikS`I*LesHc)V^P!HicwZiOs1bt`0u!0Oka4a7jy zDtfs8>9$TN8uk!-2<6CHg{+=tc2fxUr+WL{K#mbGkjd|dP`xq`13CWxa(oSV@)7Cm z5=v+E%cs56L6W?B9ZSUIgun!?Hg)X4$Y82UOK1Y<9^~$Ftl+X!9@o ze8ND)trIn)x|_N>9xJ5y41Ieb)g`RDWT^mfytAjhRC1yNqycA7d!zkrSF$L8QIoeq zL{m4A;TPw+m8@()*$Ro4C>)=GXg~31Ame{$7Pnfgkf4X4qz&YMh}yg#qLz%PLe%f0 zX+0)fcMrh<_$}PWIZ*xNqMET*NV11mA@>E)#zRyjC7@}$q zF_2pXT(Y9I>4(p^-|dZ#n>>TskM1s0`>62UJ%k3R2FO6vh{63<$Pl2}rf!8$h88aj zRY8$rW|t^RpydzBsR35+HxMgC%9*F1_EJe0um8G|wK@RZN*4B~dL3dQ!`2eL(Pbdo zLk^Nb+_~8bp^OyI=(h*rH>mutR}V>yC8Ag%bl|mo+DjdbmV|E8UK+1~48*F}A?<-s z24@FocF7_DIR5HsF9lc~fLhWFMBK|VkY=wV7)Uc9SW|=3(&~~GO{nFwEb@Tp010sR z-deQ329iAOH4u{6c*bA6m-X~OsN~Qznm!*bSy2GgzxHS9(EwzddbB?Vl3cP3#4ml` zbSueckX!sud&swpUaT0k zWU0Wz3O{-NF@BGMsFDBS{;MW#AfFLXcLs=?frtykr!QHnJ%uthy0=B`XDK4BWEse{ z6F~xf+0+fhKq$E$Uhit+WhJYdVs-&wAQyF3W#R^6Ah!rqmylhjxziL}53K0Y5l65U$X)AU0>!Sx=*$P=zqLz6`wqguKl>ppth1?I2OV(#x zetpS`mau5a>H?sRhZsn+l4T$Ua)^LSmN-kJS(xe}T>-T95VeFEh?wEg+pUmj1d~5+ zAjtvEZf*pmwtw~=KegTL`fz^8f$< literal 0 HcmV?d00001 diff --git a/docs/conf.py b/docs/conf.py index 0b78137dc..15d12e548 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -123,6 +123,9 @@ "type": "fontawesome", } ], + "logo": { + "text": "Folium", + }, } # Add any paths that contain custom themes here, relative to this directory. @@ -130,14 +133,14 @@ # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". -html_title = "Folium documentation" +# html_title = "Folium documentation" # A shorter title for the navigation bar. Default is the same as html_title. # html_short_title = None # The name of an image file (relative to this directory) to place at the top # of the sidebar. -# html_logo = None +html_logo = "_static/folium_logo.png" # The name of an image file (within the static path) to use as favicon of the # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 diff --git a/docs/index.rst b/docs/index.rst index dcc20f260..68f59e496 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -3,25 +3,27 @@ Folium ###### -.. image:: _static/folium_logo.jpg +.. image:: _static/folium_logo.png + :height: 100px -**Python data, leaflet.js maps** -``folium`` builds on the data wrangling strengths of the Python ecosystem and -the mapping strengths of the ``leaflet.js`` library. -Manipulate your data in Python, -then visualize it in on a Leaflet map via ``folium``. +Python data, leaflet.js maps +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Folium builds on the data wrangling strengths of the Python ecosystem and the +mapping strengths of the `Leaflet.js `_ library. +Manipulate your data in Python, then visualize it in a Leaflet map via Folium. Concepts ======== -``folium`` makes it easy to visualize data that's been manipulated in Python on an interactive leaflet map. -It enables both the binding of data to a map for ``choropleth`` visualizations +Folium makes it easy to visualize data that's been manipulated in Python on an interactive leaflet map. +It enables both the binding of data to a map for choropleth visualizations as well as passing rich vector/raster/HTML visualizations as markers on the map. The library has a number of built-in tilesets from OpenStreetMap, Mapbox, and Stamen, and supports custom tilesets. -``folium`` supports both Image, Video, GeoJSON and TopoJSON overlays and has a +Folium supports both Image, Video, GeoJSON and TopoJSON overlays and has a number of vector layers built-in.