{"id":19714046,"url":"https://github.com/grails/grails-howtos","last_synced_at":"2025-04-29T18:31:49.081Z","repository":{"id":2205309,"uuid":"3154094","full_name":"grails/grails-howtos","owner":"grails","description":"The source and build for a set of Grails HOWTO documents","archived":true,"fork":false,"pushed_at":"2013-10-08T11:55:56.000Z","size":654,"stargazers_count":47,"open_issues_count":1,"forks_count":12,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-04-20T15:22:15.655Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Groovy","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grails.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-01-11T14:09:01.000Z","updated_at":"2024-12-05T02:41:37.000Z","dependencies_parsed_at":"2022-09-08T07:50:12.132Z","dependency_job_id":null,"html_url":"https://github.com/grails/grails-howtos","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/grails%2Fgrails-howtos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grails%2Fgrails-howtos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grails%2Fgrails-howtos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grails%2Fgrails-howtos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grails","download_url":"https://codeload.github.com/grails/grails-howtos/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250735825,"owners_count":21478681,"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":[],"created_at":"2024-11-11T22:28:42.379Z","updated_at":"2025-04-29T18:31:48.977Z","avatar_url":"https://github.com/grails.png","language":"Groovy","funding_links":[],"categories":[],"sub_categories":[],"readme":"Grails HOWTOs\n=============\n\nGrails is a modern rapid web application development framework for the JVM. It has its [own user guide] (http://grails.org/doc/latest/) that contains lots of reference material. This project _does not_ replace that. Instead, it complements the user guide by providing standalone documents that explain how to do one thing. The idea is that these HOWTO guides will be created and maintained by the community.\n\nIf you would like to contribute, simply send an internal GitHub message to 'pledbrook' requesting commit access. Once granted access, you will be able to directly commit to this repository.\n\nBuilding\n--------\n\nOnce you have cloned the repository locally, all you have to do is run\n\n    ./gradlew docs\n\nfrom the root of the project. This will generate all the HOWTO guides in all the languages inside the `build/docs` directory. If you would like to generate the guides only for a particular language, simply add the language suffix. For example,\n\n    ./gradlew docs_fr\n\nwill generate the French HOWTO guides but no others.\n\nCreating a HOWTO\n----------------\n\nAll the guides are standalone gdoc files that reside under the `src/$lang` directories. To add a standard English guide, simply put it in the `src/en` directory.\n\nThe only requirements of the source file are that the first line is an `h1.` heading, which becomes the title of the HOWTO, and `h2.` is used for the top-level sections. Links between HOWTOs are not supported at this moment in time.\n\nAs soon as you create the gdoc file, it will be processed automatically by the build. The resulting HTML file has the same base name as the gdoc file.\n\nCommunity\n---------\n\nThis will be an open repository allowing anyone who's interested to contribute. On the flip side, there is no central editorial control, so contributors are expected to police the system themselves to prevent abuse.\n\nCustomising the styling\n-----------------------\n\nThe HTML layout for the HOWTO guides is defined in the file `resources/templates/how-to-template.html`. Static resources required by the template, such as images and stylesheets, should be placed in the respective directory under `resources/images`, `resources/css` and `resources/js` as appropriate.\n\nWhen adding links to static resources inside the template, be sure to use the `resourcesPath` variable like so:\n\n     \u003clink href=\"${resourcesPath}/css/main.css\" type=\"text/css\" ...\u003e\n\nThis ensures that the template works regardless of whether the generated guide is in a language-specific directory or not.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrails%2Fgrails-howtos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrails%2Fgrails-howtos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrails%2Fgrails-howtos/lists"}