{"id":13533653,"url":"https://github.com/wagtail/guide","last_synced_at":"2025-04-01T22:30:23.409Z","repository":{"id":38012241,"uuid":"496950708","full_name":"wagtail/guide","owner":"wagtail","description":"A website to teach Wagtail CMS to content editors, moderators and administrators.","archived":false,"fork":false,"pushed_at":"2025-02-27T11:30:25.000Z","size":1007,"stargazers_count":32,"open_issues_count":64,"forks_count":26,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-02-27T14:49:37.822Z","etag":null,"topics":["django","hacktoberfest","tutorials","wagtail"],"latest_commit_sha":null,"homepage":"https://guide.wagtail.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wagtail.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-27T10:15:00.000Z","updated_at":"2025-02-27T11:30:28.000Z","dependencies_parsed_at":"2024-07-23T09:13:37.318Z","dependency_job_id":"453b4ef5-f7a7-415c-987b-fa37672dda4e","html_url":"https://github.com/wagtail/guide","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wagtail%2Fguide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wagtail%2Fguide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wagtail%2Fguide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wagtail%2Fguide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wagtail","download_url":"https://codeload.github.com/wagtail/guide/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246720389,"owners_count":20822893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["django","hacktoberfest","tutorials","wagtail"],"created_at":"2024-08-01T07:01:21.846Z","updated_at":"2025-04-01T22:30:22.815Z","avatar_url":"https://github.com/wagtail.png","language":"Python","funding_links":[],"categories":["Open-source sites"],"sub_categories":["Package lists"],"readme":"# Guide\n\nGuide is a website to help content editors, moderators, administrators, and other users learn how to use the Wagtail content management system (CMS).\n\nThe Wagtail guide will ultimately include:\n\n-   Tutorials\n-   How-to articles\n-   Reference materials\n-   Walkthroughs and visual learning materials\n\nYou can learn more about the documentation system [here](https://documentation.divio.com/).\n\n# Table of Contents\n\n-   [Installation](#installation)\n-   [Gitpod](#gitpod)\n-   [Contributing](#contributing)\n-   [Other Notes](#other-notes)\n\n# Installation\n\nWe assume that you have basic knowledge of Node/Webpack and Python/Django/Wagtail in these instructions. We recommend you develop Wagtail Guide locally on your machine using `venv` and [fnm](https://github.com/Schniz/fnm) to ensure you are on the correct Node version.\n\n#### Dependencies\n\n-   Git\n-   Python \u003e= 3.11\n-   Poetry \u003e= 1.7.0\n-   Node (see `.nvmrc` for version)\n\n### Setting up Wagtail guide in a virtual environment\n\nRun:\n\n    python -V\n\nConfirm that the output is showing version Python 3.11 (or higher). If not, you may have multiple versions of Python installed on your system and will need to switch to the appropriate version when creating the virtual environment.\n\nWith the Python version output confirmed, [install Poetry](https://python-poetry.org/docs).\n\nNow we're ready to set up the guide project:\n\n    cd ~/dev [or your preferred dev directory]\n    git clone https://github.com/wagtail/guide.git\n    cd guide\n    make backend\n    make frontend\n    make buildfixtures\n\nOnce the backend and frontend have been set up, you can run the development server with:\n\n    make run\n\nIf everything worked, [http://127.0.0.1:8000](http://127.0.0.1:8000) should show you a welcome page.\n\nYou can access the administrative area at [http://127.0.0.1:8000/admin](http://127.0.0.1:8000/admin) and log in using the credentials you created during the backend setup.\n\nTo activate Poetry's virtual environment, run:\n\n    poetry shell\n\nTo generate and compile translation strings, run:\n\n    make makemessages\n    make compilemessages\n\nOr both, in a single command:\n\n    make translations\n\n### Setting up development with Docker\n\n1. Create a `.env` file in the project root containing these variables, you can adjust the values to your preferences:\n    ```\n    ALLOWED_HOSTS=localhost\n    PORT=8000\n    SECRET_KEY=some-random-secret\n    DJANGO_SETTINGS_MODULE=apps.guide.settings.dev\n    ```\n2. Build the image by running the `make docker-build` command.\n3. Run the container with `make docker-run`.\n4. Run the init script in the container: `make docker-init`\n5. You should now have access to the project in your browser at `http://localhost:8000`\n\n# Gitpod\n\nWith Gitpod you can deploy a ready-to-code Wagtail Guide development environment with a single click to evaluate the code.\n\n[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/wagtail/guide)\n\nSteps:\n\n1. Click the `Open in Gitpod` button.\n2. Relax: a development environment with an active Wagtail Guide site will be created for you.\n3. Login at `/admin/` with username `admin` and password `changeme`\n\n# Contributing\n\nIf you're a Python or Django developer, fork the repo and join us. You'll find answers to many common new contributor questions in our [contributing guidelines](https://docs.wagtail.org/en/stable/contributing/index.html).\n\n## Development\n\n-   Run formatting (Black \u0026 Prettier) `make format`\n-   Run linting (Ruff, Black, Prettier, Eslint) `make lint`\n-   Run tests `make test`\n\n# Other Notes\n\n## Google Summer of Code\n\nThis project is one of three [Wagtail](https://wagtail.org/) projects being sponsored by Google as a part of [Google Summer of Code 2022](https://summerofcode.withgoogle.com/). The team for this project includes:\n\n### Contributor\n\n-   [Hitansh Shah](https://github.com/Hitansh-Shah)\n\n### Mentors\n\n-   [Thibaud Colas](https://github.com/thibaudcolas)\n-   [Coen van der Kamp](https://github.com/allcaps)\n-   [Meagen Voss](https://github.com/vossisboss)\n\nYou can learn more about our Google Summer of Code project in [Google Summer of Code: Wagtail Editor Guide](https://wagtail.org/blog/google-summer-of-code-wagtail-editor-guide/), [Wagtail CMS projects for Google Summer of Code 2022](https://wagtail.org/blog/wagtail-cms-projects-for-google-summer-of-code-2022/) or on our [wiki page](https://github.com/wagtail/wagtail/wiki/Google-Summer-of-Code-2022).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwagtail%2Fguide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwagtail%2Fguide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwagtail%2Fguide/lists"}