{"id":19501034,"url":"https://github.com/grame-cncm/faustdoc","last_synced_at":"2025-02-25T21:25:58.343Z","repository":{"id":46583788,"uuid":"240055707","full_name":"grame-cncm/faustdoc","owner":"grame-cncm","description":"The Faust Online Documentation","archived":false,"fork":false,"pushed_at":"2025-02-15T13:17:07.000Z","size":375014,"stargazers_count":10,"open_issues_count":2,"forks_count":12,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-02-15T14:22:49.477Z","etag":null,"topics":["faust"],"latest_commit_sha":null,"homepage":null,"language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grame-cncm.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-02-12T16:07:00.000Z","updated_at":"2025-02-15T13:17:11.000Z","dependencies_parsed_at":"2023-10-13T07:39:36.061Z","dependency_job_id":"568ea891-6160-4c82-81f1-b1f9dcfffb20","html_url":"https://github.com/grame-cncm/faustdoc","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/grame-cncm%2Ffaustdoc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grame-cncm%2Ffaustdoc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grame-cncm%2Ffaustdoc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grame-cncm%2Ffaustdoc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grame-cncm","download_url":"https://codeload.github.com/grame-cncm/faustdoc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240748932,"owners_count":19851370,"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":["faust"],"created_at":"2024-11-10T22:10:56.105Z","updated_at":"2025-02-25T21:25:58.306Z","avatar_url":"https://github.com/grame-cncm.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Faust Online Documentation\n\n[Faust](https://faust.grame.fr) is a Functional Programming Language for sound synthesis and audio processing with a strong focus on the design of synthesizers, musical instruments, audio effects, etc. Faust targets high-performance signal processing applications and audio plug-ins for a variety of platforms and standards.\n\nThis repository is intended to build the documentation of the Faust environment, and to provide the corresponding examples. \n\n### Prerequisites\n- you must have python, pip and [mkdocs](https://www.mkdocs.org/) installed.\n- you must have the Faust source code installed. You can get it from [github](https://github.com/grame-cncm/faust). **Be sure to use a fresh cloned repository and to correcly install submodules with `git submodule update --init`**. The exact location can possibly be set in the make command using the `FAUSTDIR`  environment variable.\n- you must have openssl installed for base64 conversion.\n\n###  WARNING: adding new files\n\nBe sure to add new files in the `mkdocs/docs`, and **not** in the `docs` which is the folder generated by the build process.\n\n### Building the documentation\n\nThe build process is based on `make`. Building the documentation site is based on [mkdocs](https://www.mkdocs.org/).\nTo install the required components type:\n~~~~~~~~~~~~~~~~\n$ make install\n~~~~~~~~~~~~~~~~\n\nThe documentation embeds a lot of Faust examples that have to be embedded into html files. \nIt also extracts tags documentation from the library source code.\nTo generate all these files type:\n~~~~~~~~~~~~~~~~\n$ make all\n~~~~~~~~~~~~~~~~\n\n### Testing and generating\n\nYou can test the web site using the mkdoc embedded web server. This server also scan any change in the source directory and refresh the pages dynamically which is really convenient for the development process. To launch the server type:\n~~~~~~~~~~~~~~~~\n$ make serve\n~~~~~~~~~~~~~~~~\n\nWhen ready, you can generate the documentation web site. Type:\n~~~~~~~~~~~~~~~~\n$ make build\n~~~~~~~~~~~~~~~~\nThe web site will be available from the `docs` folder at the root of the `faustdoc` folder\n\nMore details on the build process:\n~~~~~~~~~~~~~~~~\n$ make help\n~~~~~~~~~~~~~~~~\n\n### Publishing \n\nThe docs folder at rool level contains all files that will be published. To make the current version publicly available:\n- add all the new files using `git add docs`\n- commit using `git commit -am \"message\"` (so new files and deleted files will be commited, except docs/CNAME file) \n- and push the commit\n\n### WARNING!!\n\n- never delete the **docs/CNAME file** (which is mandatory for the final generated site to work)\n- in case it has been removed, restore it using `git checkout docs/CNAME`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrame-cncm%2Ffaustdoc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrame-cncm%2Ffaustdoc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrame-cncm%2Ffaustdoc/lists"}