{"id":18587661,"url":"https://github.com/darktable-org/luadocs","last_synced_at":"2025-08-07T01:36:43.101Z","repository":{"id":48618215,"uuid":"309460500","full_name":"darktable-org/luadocs","owner":"darktable-org","description":"darktable lua api documentation","archived":false,"fork":false,"pushed_at":"2025-02-06T00:12:38.000Z","size":428,"stargazers_count":5,"open_issues_count":4,"forks_count":12,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-02-06T01:22:10.350Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/darktable-org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2020-11-02T18:30:43.000Z","updated_at":"2025-02-06T00:12:42.000Z","dependencies_parsed_at":"2024-01-02T02:02:24.112Z","dependency_job_id":"1ea904ce-5dfe-44bf-b051-74f95e357c60","html_url":"https://github.com/darktable-org/luadocs","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/darktable-org%2Fluadocs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darktable-org%2Fluadocs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darktable-org%2Fluadocs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darktable-org%2Fluadocs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/darktable-org","download_url":"https://codeload.github.com/darktable-org/luadocs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239340494,"owners_count":19622704,"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-07T00:40:16.825Z","updated_at":"2025-02-17T17:57:51.431Z","avatar_url":"https://github.com/darktable-org.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# darktable Lua Documentation\n\nThis is the user documentation for the [darktable](https://darktable.org) [Lua](https://lua.org) extensions. The content is authored in markdown and rendered to HTML using [Hugo](https://gohugo.io) and to PDF and ePub using the [DITA Open Toolkit](https://dita-ot.org).\n\nThe auto-built version of the website can be found at https://darktable-org.github.io/luadocs/.\n\n## Contributing\n\nPlease see https://darktable-org.github.io/dtdocs/special-topics/contributing/ for information about contributing content\n\n## Obtaining and Building\n\n### Cloning\n\nThe theme for the site uses https://gitlab.com/patdavid/hugo-bootstrap-bare as a git submodule.\nIn order to clone this submodule along with the site you just need to add the flag `--recurse-submodules` to the clone command:\n\n    git clone --recurse-submodules https://github.com/darktable-org/dtdocs.git\n\nIf you already have the site cloned, but haven't included the submodule before:\n\n    git submodule update --init --recursive\n\n\n### Hugo\n\nThis site is built with the static site generator Hugo (*extended*).\nCurrently v0.75.1 extended:\n```\n$ ./hugo version\nHugo Static Site Generator v0.73.0/extended windows/amd64 BuildDate: unknown\n```\n\n#### SASS\n\nIf cloning the repo fresh, remember to build the bootstrap assets locally:\n\n```\n$ cd ./themes/hugo-bootstrap-bare/assets/\n$ yarn install (or alternatively `npm install`)\n$ cd ../../hugo-darktable-docs-theme/assets/\n$ yarn install\n```\n\n### Updating\n\nIf you have the repo cloned but need to update things, it helps to make sure everything is up to date (since we are also using a submodule for the base theme).\n\nAs normal, from the project root directory, update things like normal:\n```\ngit pull\n```\n\nDouble check that the submodule is being updated as well:\n```\ngit submodule update --init --recursive\n```\n\nAnd finally make sure the assets are built:\n```\ncd themes/hugo-bootstrap-bare/assets/\nyarn install (or alternatively `npm install`).\n```\nThis should get things up and running.\n\n\n### Building\n\nYou can build the HTML website locally, the production site to deploy to hosting, or the PDF.\n\n## Local Website\n\nBuilding the site to test locally can be done from the root of the repo.\n\n```\n$ hugo server -D --disableFastRender\n```\n\nThe site should then be available at http://localhost:1313/luadocs/\n\n## Production Website\n\nRun the `hugo` command:\n\n```\nhugo\n```\n\nThe static files are now available to deploy to a webhost in the `public` directory. This is currently performed automatically when new changes are pushed to the master branch, via github Actions.\n\n## PDF\n\nEnsure you have the [`weasyprint`](https://weasyprint.org) application installed; this will transform the generated HTML to PDF.\n\n```\nmkdir -p public\nhugo server --disableFastRender --config config-pdf.yaml\nweasyprint http://localhost:1313/dtdocs/index.html public/darktable_lua_documentation.pdf\npkill hugo\n```\n\nThe PDF is available in the `public` directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarktable-org%2Fluadocs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarktable-org%2Fluadocs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarktable-org%2Fluadocs/lists"}