{"id":34775583,"url":"https://github.com/openecos-projects/website-src-mkdocs","last_synced_at":"2026-05-25T11:31:29.387Z","repository":{"id":322734440,"uuid":"1088109434","full_name":"openecos-projects/website-src-mkdocs","owner":"openecos-projects","description":"Website Sources by using MkDocs Material + Tailwindcss.","archived":false,"fork":false,"pushed_at":"2026-05-21T11:18:25.000Z","size":125,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-21T19:09:49.622Z","etag":null,"topics":["mkdocs-material","tailwindcss","website"],"latest_commit_sha":null,"homepage":"https://openecos.com","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openecos-projects.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-02T10:32:51.000Z","updated_at":"2026-05-21T11:18:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/openecos-projects/website-src-mkdocs","commit_stats":null,"previous_names":["openecos-projects/website-src-mkdocs"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/openecos-projects/website-src-mkdocs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openecos-projects%2Fwebsite-src-mkdocs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openecos-projects%2Fwebsite-src-mkdocs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openecos-projects%2Fwebsite-src-mkdocs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openecos-projects%2Fwebsite-src-mkdocs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openecos-projects","download_url":"https://codeload.github.com/openecos-projects/website-src-mkdocs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openecos-projects%2Fwebsite-src-mkdocs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33473699,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T06:32:55.349Z","status":"ssl_error","status_checked_at":"2026-05-25T06:32:35.322Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["mkdocs-material","tailwindcss","website"],"created_at":"2025-12-25T08:16:14.027Z","updated_at":"2026-05-25T11:31:29.379Z","avatar_url":"https://github.com/openecos-projects.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ECOS Website Sources\n\n## Introduction\n\nThis repository contains the source files for the ECOS Website, generated with **MkDocs Material + Tailwindcss** as a bilingual site (`web/src/zh` and `web/src/en`) with a lightweight frontend asset pipeline for consistent local preview and production output.\n\n## Usage\n\nBefore running commands, make sure your environment has Python 3.10+, Node.js 22+ and Git.\n\n- Setup\n\n  Initialize shared repositories (`res` and `tpl`) and prepare the local project workspace.\n\n  ```bash\n  cd web\n  make setup\n  ```\n\n- Edit\n\n  Please follow the workflow to add new images or videos:\n\n    - Upload lossless original images (JPG or PNG format) or pre-compressed videos (MP4 format) to the corresponding directory under `web/res/img`.\n    - Run `make gen-webp` command in the `web` directory, and scripts in `web/tpl` will automatically convert original images to smaller WEBP images (lossy compression).\n    - Reference the generated WEBP images in your Markdown files.\n\n  **Note:** running `make gen-webp` command is optional. If you run `make serve-web` command in the next **Preview** step, the system will also convert images automatically. **Video compression is not currently supported by script, so please compress videos in advance before uploading them to `web/res/img`.**\n\n- Preview\n\n  Start a local development server for the Chinese site (default language).\n\n  ```bash\n  cd web\n  make serve-web\n  ```\n\n  Start a local development server for the English site.\n\n  ```bash\n  cd web\n  make serve-web MKDOCS_LANG=en\n  ```\n\n- Build\n\n  Generate dynamic assets and build the Chinese static site output.\n\n  ```bash\n  cd web\n  make gen-web\n  make build-web\n  ```\n\n  Generate dynamic assets and build the English static site output.\n\n  ```bash\n  cd web\n  make gen-web MKDOCS_LANG=en\n  make build-web MKDOCS_LANG=en\n  ```\n\n- Deploy\n\n  If you modify files in local `web/res` or `web/tpl` (for example, add new images, templates, scripts, or styles), commit and push those changes to their corresponding repositories first.\n\n  Commit and push your changes in `web/src` to the repository. Then Vercel (a cloud platform designed to simplify web development) will detect the update of the repository, automatically build and deploy the website according to `vercel.json` config file.\n\n- Clean\n\n  Remove generated files and local build artifacts for a fresh rebuild.\n\n  ```bash\n  cd web\n  make clean\n  ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenecos-projects%2Fwebsite-src-mkdocs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenecos-projects%2Fwebsite-src-mkdocs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenecos-projects%2Fwebsite-src-mkdocs/lists"}