From a69bbffbf1383b4df363ab404b33734a47136d9c Mon Sep 17 00:00:00 2001 From: Augustin Husson Date: Tue, 17 Sep 2024 11:45:42 +0200 Subject: [PATCH] add LF footer, social icons, favicon and logo and instruction to run the new website Signed-off-by: Augustin Husson --- .gitignore | 1 + .yamllint.yaml | 2 +- README.md | 22 ++++++++++++++++++++++ docs/assets/images/favicon.png | Bin 0 -> 2035 bytes mkdocs.yml | 20 ++++++++++++++++++-- 5 files changed, 42 insertions(+), 3 deletions(-) create mode 100644 docs/assets/images/favicon.png diff --git a/.gitignore b/.gitignore index 7da3856..ef7506d 100644 --- a/.gitignore +++ b/.gitignore @@ -280,3 +280,4 @@ $RECYCLE.BIN/ # Docker compose config secret (ask maintainers) secret +/venv diff --git a/.yamllint.yaml b/.yamllint.yaml index 977f803..f40ce4f 100644 --- a/.yamllint.yaml +++ b/.yamllint.yaml @@ -3,4 +3,4 @@ extends: default rules: document-start: disable line-length: - max: 164 + max: 250 diff --git a/README.md b/README.md index 09284ad..c86a080 100644 --- a/README.md +++ b/README.md @@ -5,3 +5,25 @@ This repository contains everything required to start the Perses demo, the docum ## Instructions On the machine, just pull this repository and run `podman-compose up -d` + + +### Start the website locally + +We recommend you to create a python virtual environment. + +```bash +python3 -m env venv +source ./venv/bin/activate +``` + +Then you can install de libs required to run the Perses website: + +```bash +pip install -r requirements.txt +``` + +And finally you can run the server: + +```bash +mkdocs serve -a "localhost:8080" +``` diff --git a/docs/assets/images/favicon.png b/docs/assets/images/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..8786b8568c8c9e03187c6459afeb9f0d50abb8ee GIT binary patch literal 2035 zcma)+X;c#E8pm;87^SY$XsLN;Y^>DMG_h+Av>0ZJTcT2_*_6g8uDM;@b1Tzw$&Icp zG@_=GfGD8kU}}nJT8<+GVut%dk{Tj-alZBCp8KBjywCZ+=l{O%hyVFKcRbylb+q?s z0{{RWm-9~EiZ0qIO?AZ%LCh5^npV_#WGn#i!_PaVCN;1KsNa$n(rR?P6uk3T>M@0A0nQ zQ$5B*~I-6TW056vaF=35emVp_Ctl>zD7Y8s6oF*q`w#%bSLrU5N6zq0;_l)%<(XhpZg~=?X8wek64`e-<`j zaj>|M@Wt|0iL<`s(j1d)$FsW>n1i!07RdEGumh{z6>VU;D{jTQpP&L|_a>k({a9Tq z=Qy%gR+#?`d3R?mG%)Zu$_R;la5fPdkoCtv{X-(O>CceQ{A%vSFbaGPAPKo%dqczkyg3Dc7<@~X(Bl%+pk%Y)zTL!11ftz0Dx*EyB8y{+q00W;A)E0jAddz=#5d|{}w`* z?{!VYuYB%mG4IuMe2_c5akO-}fH{F!pn#P@*UNbhr6UE*nZvMj4WeWC`zH@-1U>td z_MZ>yXnnSF@g4vax~CrbyMa;;Q#J7f|Gl3FHO#E@_FNFv

+xttmRiv1DX`j1yYMy9`n^umlRo|6$bugH$bH(9aNMo_hT2!B<<%G-JmNnI_NQf96$t&CY~$NE zHdjYCS5pl(QdsA(>+waxHDnVw z_&5nDdP+2loLZ~K6L|;AheEuOws9ma(NjtE2E?HPf9>5^i?3AymWEXQ`eVEOv3Ym+ z1oa9-65Zdg;h%WWBTvJJp}#pvN!n90|Jd13-P55{mW6N>`@T$V^EE=w0iXlmi|Ju@ z_lQc61~Dz}==IU^@!TCQQsN0`4@)gm|7H-*nR!|o(Kpo_<&*t51B*D+1LPGpt{y1s zV6U}>I8VzuJ^h7%$g_6b9lSo6wLYyvpQ!IQ6_tBlum`3X@1U!X49vb(hTSnFm%WfK z!#Gy|-p!lE2%SbgKdjDhrBBXA zLeR`7A>%+^E7Y=NtdUaKjNWYF+dd@XD$>f>pb#JeB|W3J2d@lnTfv%VPN8B=Wy3 zmz2KAE6OPr3ff96Z@@14N`_`KxKc1{$%cw}+v77pDf(4`8z3mu0Gkpca}%o`1e4qw z#Bo@jR53KC{sN=opwTv@q>kBuz>Xy*rsOk|d$|P_v6*%0>=?g zoY1i`u?exx>@V?u;WlP&ojJbvIy2Hs2=GWM8~g4!?vRl{{;=%gXt?685AB&0oGe^AMmf?Rw(fBT(A zt<;WlJ=t(l=o8{+fvGJ;^L3&7HgFM`q?$`*dR6FVX+U5Ty{}QcY=(pGCC@9%Ot2@b tQZb(>bj0=ukCN>BGw_=X|A*-GmxFfsuO@%qO>xtw!%YC3Z@^S^PE+4%qf literal 0 HcmV?d00001 diff --git a/mkdocs.yml b/mkdocs.yml index 1603a12..4705b4e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,9 +1,10 @@ site_name: Perses site_url: "https://perses.dev" -repo_name: "Perses on GitHub" +repo_name: "perses/perses" repo_url: "https://github.com/perses/perses" theme: name: material + logo: assets/images/favicon.png palette: # Palette toggle for automatic mode - media: "(prefers-color-scheme)" @@ -54,8 +55,23 @@ extra_css: # extra_javascript: # - 'js/main.js' -# Enable versioning +copyright: | + The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage + extra: + # used to remove the text "made with material for mkdocs: https://squidfunk.github.io/mkdocs-material/setup/setting-up-the-footer/#generator-notice" + generator: false + social: + - icon: fontawesome/brands/github + link: https://github.com/perses + - icon: fontawesome/brands/x-twitter + link: https://twitter.com/PersesDev + - icon: fontawesome/brands/linkedin + link: https://linkedin.com/company/persesdev + - icon: fontawesome/brands/slack + link: https://cloud-native.slack.com/messages/C07KQR95WBE + - icon: fontawesome/brands/docker + link: https://hub.docker.com/r/persesdev/perses version: provider: mike