-
Notifications
You must be signed in to change notification settings - Fork 0
/
contribute.html
6 lines (5 loc) · 16.9 KB
/
contribute.html
1
2
3
4
5
6
<!DOCTYPE html><html class="bg-white dark:bg-gray-900 dark:text-gray-100 leading-tight text-gray-900" lang=en><head><meta charset=UTF-8><meta content="width=device-width, initial-scale=1, shrink-to-fit=no" name=viewport><link href=/assets/favicons/apple-touch-icon.png rel=apple-touch-icon sizes=180x180><link href=/assets/favicons/favicon-32x32.png rel=icon sizes=32x32 type=image/png><link href=/assets/favicons/favicon-16x16.png rel=icon sizes=16x16 type=image/png><link href=/assets/favicons/site.webmanifest rel=manifest><link color=#000000 href=/assets/favicons/safari-pinned-tab.svg rel=mask-icon><link href=/assets/favicons/favicon.ico rel="shortcut icon"><meta content=Pushword name=apple-mobile-web-app-title><meta content=Pushword name=application-name><meta content=#fff name=msapplication-TileColor><meta content=/assets/favicons/browserconfig.xml name=msapplication-config><meta content=#fff name=theme-color><title> Contribute to Pushword : Documention, Core or Extension </title><link href=/assets/tw.css rel=stylesheet><style>:root{--primary:#ef8206;--secondary:#d97706;--font-family:Inter var,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol}</style><style>.nojs{display:block}</style><script>document.head.insertAdjacentHTML('beforeend','<style>.nojs{display:none !important}<\/style>')</script><link href=https://pushword.piedweb.com/feed.xml rel=alternate title="Pushword » Flux" type=application/rss+xml><link href=https://pushword.piedweb.com/contribute rel=canonical><link href=https://pushword.piedweb.com/contribute hreflang=en rel=alternate><meta content="Contribute to Pushword : Documention, Core or Extension" name=og:title><meta content=https://pushword.piedweb.com/contribute name=og:url> <body><div class="flex flex-wrap items-stretch max-w-screen-2xl mx-auto"><div class="lg:ml-0 lg:mr-0 lg:w-3/4 mx-auto order-2 w-full"><div class=pt-6></div> <div class="flex flex-wrap max-w-5xl"><div class="lg:order-1 lg:w-4/5 order-2 overflow-hidden w-full"><div class="dark:prose-light max-w-none p-3 prose"><h1>Contribute</h1> <p>Source code is host on <span data-rot=_tvguho.pbz/Chfujbeq/Chfujbeq><svg class="-mt-1 fill-current inline-block w-4" viewbox="0 0 496 512"><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"></path></svg> github</span>.</div> </div> <div class="lg:order-2 lg:w-1/5 order-3 overflow-hidden w-full"><div class="lg:absolute lg:border-gray-200 lg:border-l lg:max-w-xs m-2 max-w-screen-sm p-3 pt-4 rounded"><h3 class="block dark:text-gray-100 font-semibold lg:mb-3 lg:text-xs mb-3 px-1 text-gray-900 text-sm tracking-wide uppercase">Contents</h3> <div class="-ml-6 dark:prose-light max-w-none prose-sm px-1"><ul><li class=first><a href=#signale-an-issue>Signale an issue</a> <li><a href=#contribute>Contribute</a> <li><a href=#contribute-to-the-documentation>Contribute to the documentation</a> <li class=last><a href=#pull-requests>Pull Requests</a> <ul class=menu_level_1><li class=first><a href=#new-features>New Features</a> <li><a href=#coding-standards>Coding standards</a> <li><a href=#tests>Tests</a> <li class=last><a href=#other-requirements>Other Requirements</a> </ul></ul> </div></div> </div> <div class="lg:w-4/5 order-4 overflow-hidden w-full"><div class="dark:prose-light max-w-3xl p-3 prose"><h2 id=signale-an-issue>Signale an issue</h2> <p>Use the <span data-rot=_tvguho.pbz/Chfujbeq/Chfujbeq/vffhrf>github issue tracker</span> to signal an issue. <blockquote><p>This project is open source, and as such, the maintainers give their free time to build and maintain the source code held within. They make the code freely available in the hope that it will be of use to other developers. It would be extremely unfair for them to suffer abuse or anger for their hard work. </blockquote> <h2 id=contribute>Contribute</h2> <p>Contributions are <strong>welcome</strong>. <p>Please, send your contribution via a <span data-rot=_tvguho.pbz/Chfujbeq/Chfujbeq/chyyf>github pull request</span> on <span data-rot=_tvguho.pbz/Chfujbeq/Chfujbeq>Puswhord/Puswhord</span>. <p>The code is mainly organised in a mono-repo, learn more about the <a href=/architecture>code architecture</a> <h2 id=contribute-to-the-documentation>Contribute to the documentation</h2> <p>The docs is inside the main repo, you will find write in markdown in <span data-rot=_tvguho.pbz/Chfujbeq/Chfujbeq/gerr/znva/cnpxntrf/qbpf/pbagrag>packages/docs/content</span>. <p>On each PR, the docs is compiled and published <a href=/>pushword.piedweb.com</a> by a github action. <h2 id=pull-requests>Pull Requests</h2> <h3 id=new-features>New Features</h3> <p>When requesting or submitting new features, first consider to create a dedicated extension. <p>If your extension reply to an important community need, you can create a pull request to merge it in this Mono Repo. It will permit to maintain easily it compatibility in next Puswhord update. Moreover, extension will be tested at each commit on one of Pushword's package. <p>Else, consider create it own git repo and create a Pull Request on the doc to add a link to this fresh extension. The link will be accepted if your extension is well tested and fully functionnal. <h3 id=coding-standards>Coding standards</h3> <p>This project respect PSR-12 Coding standard. Before your pull-request, run <code>php-cs-fixer</code>. <pre><code>composer format
</code></pre> <h3 id=tests>Tests</h3> <pre><code>composer test
# and to test with --prefer-lowest
composer tests
</code></pre> <h3 id=other-requirements>Other Requirements</h3> <p>This attention would be nice : <ul><li><p><strong>Add tests</strong> <li><p><strong>Document any change in behaviour</strong> - Make sure the <a href=../packages/docs/content/>documentation</a> are kept up-to-date. <li><p><strong>Consider our release cycle</strong> - We try to follow <a href=https://semver.org/>SemVer v2.0.0</a>. Randomly breaking public APIs is not an option. <li><p><strong>One pull request per feature</strong> - If you want to do more than one thing, send multiple pull requests. <li><p><strong>Send coherent history</strong> - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please <a href=https://www.git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Changing-Multiple-Commit-Messages>squash them</a> before submitting.</ul> <p><strong>Happy coding</strong>!</div> </div></div> <div class="flex max-w-3xl mt-5 mx-3"><a class="dark:hover:text-gray-100 flex hover:text-gray-900 mr-8 text-gray-500" href=/create-extension><span aria-hidden=true class=mr-2>←</span> Create an extension </a> <a class="dark:hover:text-gray-100 flex hover:text-gray-900 ml-auto text-gray-500 text-right" href=/architecture> The Architecture <span aria-hidden=true class=ml-2>→</span> </a></div> <div class="font-light mt-10 mx-3 text-center text-gray-500 text-sm"><span class="dark:hover:text-gray-100 hover:text-gray-900" data-rot=_tvguho.pbz/Chfujbeq/Chfujbeq/rqvg/znva/cnpxntrf/qbpf/pbagrag/pbagevohgr.zq><svg xmlns=http://www.w3.org/2000/svg class="-mt-1 fill-current inline-block w-3" viewbox="0 0 576 512"><path d="M402.6 83.2l90.2 90.2c3.8 3.8 3.8 10 0 13.8L274.4 405.6l-92.8 10.3c-12.4 1.4-22.9-9.1-21.5-21.5l10.3-92.8L388.8 83.2c3.8-3.8 10-3.8 13.8 0zm162-22.9l-48.8-48.8c-15.2-15.2-39.9-15.2-55.2 0l-35.4 35.4c-3.8 3.8-3.8 10 0 13.8l90.2 90.2c3.8 3.8 10 3.8 13.8 0l35.4-35.4c15.2-15.3 15.2-40 0-55.2zM384 346.2V448H64V128h229.8c3.2 0 6.2-1.3 8.5-3.5l40-40c7.6-7.6 2.2-20.5-8.5-20.5H48C21.5 64 0 85.5 0 112v352c0 26.5 21.5 48 48 48h352c26.5 0 48-21.5 48-48V306.2c0-10.7-12.9-16-20.5-8.5l-40 40c-2.2 2.3-3.5 5.3-3.5 8.5z"></path></svg><span class="hidden lg:inline-block ml-2">Edit via github</span></span> </div> <div class=pb-10></div></div> <div class="lg:w-1/4 order-1 w-0"><div class=h-full><input class=hidden id=right-column type=checkbox> <label class="bg-primary block bottom-0 cursor-pointer fixed h-12 hover:bg-opacity-75 left-0 m-2 p-3 w-12 z-50" for=right-column id=right-column-toggler><div class="content-center flex flex-wrap h-6 relative w-6"><span class="block border-b-2 border-gray-100 h-1 w-full"></span> <span class="block border-b-2 border-gray-100 h-1 my-1 w-full"></span> <span class="block border-b-2 border-gray-100 h-1 w-full"></span></div> </label> <div class="bg-white border-gray-200 border-r dark:bg-gray-900 dark:border-gray-700 h-full lg:block lg:border-r-0 lg:mx-auto lg:top-18 md:py-9 mr-24 overflow-hidden pl-1 pr-3 py-6 sticky text-sm w-60 z-40" id=right-column-nav><a class="block dark:text-gray-100 font-semibold lg:mb-3 lg:text-xs mb-3 mt-3 px-3 text-gray-900 text-sm tracking-wide uppercase" href=/installation> Get Started</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/> Introduction</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/installation> Installation</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/configuration> Configuration</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/upgrade> Upgrade Guide</a> <a class="block dark:text-gray-100 font-semibold lg:mb-3 lg:text-xs mb-3 mt-3 px-3 text-gray-900 text-sm tracking-wide uppercase" href=/command> Usage</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/command> Command</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/editor> Editor</a> <a class="block dark:text-gray-100 font-semibold lg:mb-3 lg:text-xs mb-3 mt-3 px-3 text-gray-900 text-sm tracking-wide uppercase" href=/themes> Theme</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/themes> Find a Theme</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/manage-assets> Customize the assets (css/js)</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/override-theme> Override the template files</a> <a class="block dark:text-gray-100 font-semibold lg:mb-3 lg:text-xs mb-3 mt-3 px-3 text-gray-900 text-sm tracking-wide uppercase" href=/extensions> Extensions</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/extensions> Find an extension</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/create-extension> Create an extension</a> <a class="block dark:text-gray-100 font-semibold lg:mb-3 lg:text-xs mb-3 mt-3 px-3 text-gray-900 text-sm tracking-wide uppercase" href=/contribute> Contribute</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 text-primary transition-colors" href=/contribute> › Issues and Pull Request</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/architecture> The Architecture</a> <a class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" href=/roadmap> Roadmap</a> <span class="block dark:text-gray-100 duration-200 hover:text-primary px-3 py-2 relative rounded text-gray-900 transition-colors" data-rot=_tvguho.pbz/Chfujbeq/Chfujbeq><div style=display:inline-block;margin-bottom:-2px><svg xmlns=http://www.w3.org/2000/svg class="bi bi-github" fill=currentColor height=16 viewbox="0 0 16 16" width=16><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.012 8.012 0 0 0 16 8c0-4.42-3.58-8-8-8z"></path></svg></div> Source Code</span></div></div> <script>document.addEventListener('DOMContentLoaded',function(){if(window.screen.width>=1025){document.querySelector('#right-column').checked=!0;document.querySelector('#right-column-toggler').classList.add('lg:hidden')}})</script> <style>#right-column:checked~label span:nth-child(1){transform:rotate(45deg) translateY(.2rem) translateX(.1rem)}#right-column:checked~label span:nth-child(2){border-color:transparent;margin:0 !important}#right-column:checked~label span:nth-child(3){transform:rotate(-45deg) translateY(-.3rem) translateX(.1rem)}#right-column:not(:checked)~#right-column-nav{height:0 !important;width:0;padding:0;margin:0}#right-column:checked~label{left:15rem}</style></div></div> <footer class="bg-gray-50 border-t border-yellow-50 dark:bg-gray-900 dark:border-gray-700 shadow-inner shadow-sm text-sm"><div class="max-w-screen-md mx-auto p-3 py-10 text-right"><a class="block hover:opacity-75 mb-3 text-2xl text-primary" href=/>Pushword</a> Crafted by Robin from <a class="hover:opacity-75 text-primary" href=https://piedweb.com>Pied Web</a>. </div> </footer> <header class="fixed flex flex-col left-0 right-0 top-0 z-50"><div class="bg-gray-50 border-b border-gray-50 dark:bg-gray-900 dark:border-gray-700 shadow-sm"><div class="flex flex-row items-center justify-between max-w-screen-2xl mx-auto px-4 py-2"><span class="block font-mono mr-1 text-2xl"><a class="flex font-bold hover:text-primary logo text-primary" href=https://pushword.piedweb.com/><span class="bg-center bg-contain fill-current h-12 inline-block text-primary w-12" style="background-image:url('/assets/logo.svg')"></span> <span class="hidden lg:inline-block ml-2 mt-2 text-small">Pushword</span></a> </span> <div class="flex flex-1 flex-row md:mx-6 mx-3"><input class="bg-white border-2 border-white dark:bg-gray-700 focus:border-primary focus:w-60 md:focus:w-full md:rounded-l md:w-full outline-none px-2 py-1 rounded rounded-r-none text-xl w-20" id=search placeholder=Search type=text> <button class="bg-primary font-bold hover:opacity-75 md:block px-4 py-2 rounded-r text-white" onclick="document.querySelector('#search').focus()"><svg xmlns=http://www.w3.org/2000/svg fill=currentColor height=16 viewbox="0 0 16 16" width=16><path d="M11.742 10.344a6.5 6.5 0 1 0-1.397 1.398h-.001c.03.04.062.078.098.115l3.85 3.85a1 1 0 0 0 1.415-1.414l-3.85-3.85a1.007 1.007 0 0 0-.115-.1zM12 6.5a5.5 5.5 0 1 1-11 0 5.5 5.5 0 0 1 11 0z"></path> </svg> </button></div> <nav class=nav><ul class="flex space-x-1"><li><a class="duration-200 font-bold hover:opacity-75 inline-block px-3 py-2 rounded text-primary transition-colors" href=/installation>Docs</a> <li><a class="duration-200 font-bold hidden hover:opacity-75 md:inline-block px-3 py-2 rounded text-primary transition-colors" href=/extensions>Extensions</a> <li><a class="duration-200 font-bold hidden hover:opacity-75 md:inline-block px-3 py-2 rounded text-primary transition-colors" href=/contribute>Contribute</a> <li><a class="duration-200 font-bold hidden hover:opacity-75 md:inline-block px-3 py-2 rounded text-primary transition-colors" href=/roadmap>Roadmap</a></ul> </nav></div> </div> <div class="bg-gray-100 flex flex-col md:px-20 px-5 rounded-b-200" id=search-results></div></header> <style>body{margin-top:85px}a.logo:hover{filter:sepia(20%)}:root{--tw-ring-color:transparent}</style> <script src=/assets/app.js></script>