{"id":19579733,"url":"https://github.com/wolfssl/documentation","last_synced_at":"2025-04-27T08:31:54.341Z","repository":{"id":65576791,"uuid":"39968095","full_name":"wolfSSL/documentation","owner":"wolfSSL","description":"wolfSSL product manuals and documentation.","archived":false,"fork":false,"pushed_at":"2025-04-22T14:33:59.000Z","size":12979,"stargazers_count":16,"open_issues_count":1,"forks_count":33,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-04-22T15:40:32.686Z","etag":null,"topics":["cryptography","documentation","getting-started","intrusion-detection","intrusion-prevention","jce","jni","jsse","mqtt","secure-boot","security","ssh","ssl","tls","tpm2"],"latest_commit_sha":null,"homepage":"https://www.wolfssl.com","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wolfSSL.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2015-07-30T19:16:21.000Z","updated_at":"2025-04-22T14:34:04.000Z","dependencies_parsed_at":"2023-02-16T22:01:15.580Z","dependency_job_id":"6178708a-ece1-481a-9bc4-7c57bd01e41b","html_url":"https://github.com/wolfSSL/documentation","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/wolfSSL%2Fdocumentation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfSSL%2Fdocumentation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfSSL%2Fdocumentation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfSSL%2Fdocumentation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wolfSSL","download_url":"https://codeload.github.com/wolfSSL/documentation/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251112529,"owners_count":21538162,"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":["cryptography","documentation","getting-started","intrusion-detection","intrusion-prevention","jce","jni","jsse","mqtt","secure-boot","security","ssh","ssl","tls","tpm2"],"created_at":"2024-11-11T07:18:50.149Z","updated_at":"2025-04-27T08:31:49.330Z","avatar_url":"https://github.com/wolfSSL.png","language":"C","readme":"# Documentation\n\nThis is the new build system for the various wolfSSL products' manuals, please see the READMEs each directory for more information. The advantages of this over previous wolfSSL manuals are:\n\n* Has a possible code review process\n* Can automatically generate PDF and HTML output\n* Has cross links between parts of the documentation\n* Has links to the required API parts\n\n## Building Documentation\n\nTo build the documentation you will need Docker running on your system. In this documentation root directory run `make` to build the documentation for every project which will output in a `build` subdirectory of this root directory (**note**: on some systems you may need to use `sudo` before `make`). You can also build individual project manuals by doing:\n\n* `make wolfssl`\n* `make wolfssh`\n* `make wolfboot`\n* `make wolfclu`\n* `make wolfcrypt-jni`\n* `make wolfmqtt`\n* `make wolfsentry`\n* `make wolfssl-jni`\n* `make wolftpm`\n* `make porting`\n* `make fips-ready`\n\n## Contributing\n\nThere is a [CONTRIBUTING.md](CONTRIBUTING.md) document which outlines how to add manuals to the tree.\n\n## Building without Docker\n\n### Pre-requisites\n\nIf you are not building using the Docker build system above you can build using Ubuntu, this will require around 3GB of packages to be installed:\n\n```sh\nsudo apt install pandoc texlive-full mkdocs doxygen\n```\n\nYou also need Doxybook2 installed which can be found at: \u003chttps://github.com/matusnovak/doxybook2\u003e. Unfortunately there is no package for this. Installation instructions can be found at: \u003chttps://github.com/matusnovak/doxybook2#Install\u003e. You'll likely have to checkout to this commit `1e5f8f0879aa1e908ccce250`.\n\nIf Doxybook2 is installed in a non-stardard path you can use the environment variable `DOXYBOOK_PATH` to set it.\n\n### Building\n\nWhen in each manual directory to build the PDF:\n\n```sh\nmake pdf\n```\n\nTo build the HTML:\n\n```sh\nmake html\n```\n\nTo build both:\n\n```sh\nmake\n```\n\nTo run a local HTML server (HTML is built to a temporary area for this):\n\n```sh\nmake serve\n```\n\n## Localization\n\nBy default, the built output documentation is in English. If you assign a language code to the DOC_LANG variable and call 'make' with it, the output will be localized in that specified language. As of now (end of 2022), the only supported language code is 'JA', which means 'Japanese'. Not all wolfSSL products documentation supports localization. 'make' with DOC_LANG variable for unsupported products is ignored and output in English.\n\n```sh\nmake DOC_LANG=JA\n```\n\n### Pre-requisites\n\nFor localization to work, the build environment must have the correct fonts installed for the specified language.\n\n#### Japanese font\n'Noto Sans CJK JP' font is used for Japanese localization. You can get the font files from the following Github repository:\nhttps://github.com/googlefonts/noto-cjk/tree/main/Sans/OTF/Japanese\n\nYou can download the seven `NotoSansCJKjp-xxx.otf` files from there and put them into `/usr/local/share/fonts`. You may need 'sudo' for the operation. After coping font files, you need to update font cache by calling:\n\n```sh\nsudo fc-cache -fv\n```\nThen you can confirm the font cache includes the installed font files by 'fc-list'.\n\n```sh\nfc-list | grep NotoSansCJKjp\n```\nYou will get the list of installed font files.\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwolfssl%2Fdocumentation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwolfssl%2Fdocumentation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwolfssl%2Fdocumentation/lists"}