{"id":27594402,"url":"https://github.com/apache/cayenne-website","last_synced_at":"2025-04-22T10:34:09.507Z","repository":{"id":21459988,"uuid":"92806420","full_name":"apache/cayenne-website","owner":"apache","description":"Mirror of Apache cayenne website","archived":false,"fork":false,"pushed_at":"2025-03-24T07:08:54.000Z","size":158777,"stargazers_count":5,"open_issues_count":11,"forks_count":7,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-18T04:07:08.902Z","etag":null,"topics":["cayenne","database","java","library","network-client","network-server","web-framework","xml"],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":false,"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/apache.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"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}},"created_at":"2017-05-30T07:00:07.000Z","updated_at":"2025-03-24T07:08:17.000Z","dependencies_parsed_at":"2025-04-17T15:07:51.262Z","dependency_job_id":null,"html_url":"https://github.com/apache/cayenne-website","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/apache%2Fcayenne-website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fcayenne-website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fcayenne-website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fcayenne-website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/cayenne-website/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250153748,"owners_count":21383665,"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":["cayenne","database","java","library","network-client","network-server","web-framework","xml"],"created_at":"2025-04-22T10:31:27.326Z","updated_at":"2025-04-22T10:34:05.577Z","avatar_url":"https://github.com/apache.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Apache Cayenne Website Sources \n\nContains sources of [Cayenne website](http://cayenne.apache.org).\n\n## How To Run\n\n### Dev mode\n\nJust clone and run maven, nothing else required.\n\n    git clone https://gitbox.apache.org/repos/asf/cayenne-website.git\n    cd cayenne-website\n    mvn\n\nOpen http://localhost:3000 in your browser. In dev mode site supports live-reloading.\n\n:grey_exclamation: _You can change host and port by setting `dev.host` and `dev.port` properties:_\n   \n    mvn -Ddev.host=\"my.local\" -Ddev.port=\"8080\"\n\n### Publish\n\nTo publish a new version just run Maven with `publish` profile. This will build a production version of the site (with cayenne.apache.org base URL) and push commit into `asf-site` branch that will be synced with actual site content location:\n    \n    mvn -Ppublish -Dmsg=\"commit message describing site changes\"\n    \nThat's all, so be careful and review your changes before publishing (also don't forget to check them after).\n\nDon't forget to push your source's changes so others won't rewrite them.\n\n*NOTE*: This process can be automated by Jenkins. It can run publish on every commit to `master`.\n\n## CMS guide\n\n### Content modifications\n\n#### Publishing news\n\nTo publish news simply add new file at `src/main/site/content/news/` folder.\nYou can use the following template: \n\n`some-good-news.md`\n\n    ---\n    title: Good news everyone!\n    date: 2017-01-01T00:00:00+03:00\n    --- \n    \n    Content goes here\n\n\n#### Releasing new cayenne version\n\nTo update site content with information about new Cayenne version you need to perform these steps:\n\n* Update data in `src/main/site/data/cayenne.yaml` file.\n* Write news (see information above).\n* Update documentation, see next section.\n  \n####  Update Cayenne Documentation\n\nThere are two helpers shell scripts to update Cayenne documentation:\n\n* build-docs.sh that updates both JavaDoc and Asciidoc\n* build-asciidocs.sh that update Asciidoc only\n\nUsage:\n\n* Update all docs after the release\n```\n    ./build-docs.sh 4.1.RC2\n```\n    \n* Add fixes to the docs\n```\n    ./build-asciidocs.sh STABLE-4.0 4.0.2\n```\n    \nThese scripts don't commit changes so you should commit them manually and publish the site as usual. \n\n\n### Advanced \n\nNode.js, Yarn, Gulp and Hugo tools are used to build this site, Maven used just to bootstrap Node.js and Yarn tools and launch Gulp tasks.\nHugo binaries managed by [hugo-bin](https://www.npmjs.com/package/hugo-bin) NPM module.\n\n#### Src structure\n\nThere are two main parts of the site src:\n* `src/main/assets` assets processed by [Gulp](https://gulpjs.com) tasks\n\n    * `/gulp/` - list of Gulp tasks\n    \n        Important tasks:\n        * `hugo.js` - contains tasks that launch Hugo to process all content\n        * `images.js` - compress and copy images\n        * `reference.js` - replace references to generated resources inside content\n        * `revision.js` - generate manifest file with resources versions\n        * `scripts.js` - launch Webpack to process JavaScript resources\n        * `serve.js` - launch dev-version of site with live-reloading\n        * `styles.js` - generate CSS bundle (concat, minify, etc..)\n    * `/images/` - images that will be compressed and published into site `/img` directory, \n    you can put any stuff used by site here (see `/gulp/images.js`)\n    * `/scripts/` - JavaScript sources, `main.js` is an entry point for the final bundle,\n    will be processed by Webpack (see `/gulp/scripts.js`)\n    * `/styles/` - Sass sources, `main.scss` is an entry point for the final bundle\n    (see `/gulp/styles.js`)\n    * `gulpfile.js` - main file for Gulp tasks, define some global path constants\n    * `package.json` - all project dependencies are defined here\n\n* `src/main/site` assets processed by [Hugo](https://gohugo.io) site generator\n\n    * `/content/` - main content part of the site, markdown and HTML files\n    * `/data/` - data files in *yaml* format\n    * `/layouts/` - site templates, using [GO templates](https://golang.org/pkg/text/template/)\n    * `/static/` - files that will be copied as is to the final site content, note that `js`, `img` and `css` directories\n    are processed via Gulp tasks, and shouldn't be used directly, instead use coresponding directories in `assets`.     \n    * `config.yaml` - Hugo configuration\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fcayenne-website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Fcayenne-website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fcayenne-website/lists"}