Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/doga/geminispace-jsdoc-server
A Gemini server for serving JSDoc documentation.
https://github.com/doga/geminispace-jsdoc-server
deno gemini-capsule geminispace jsdoc server
Last synced: 2 days ago
JSON representation
A Gemini server for serving JSDoc documentation.
- Host: GitHub
- URL: https://github.com/doga/geminispace-jsdoc-server
- Owner: doga
- License: apache-2.0
- Created: 2024-05-06T19:46:20.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-05-19T20:59:18.000Z (6 months ago)
- Last Synced: 2024-06-29T16:09:17.002Z (5 months ago)
- Topics: deno, gemini-capsule, geminispace, jsdoc, server
- Language: TypeScript
- Homepage:
- Size: 46.9 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-gemini - doc-server - A Gemini server for serving JSDoc documentation. Built on the Kaksik library. (Servers / Graphical)
README
# ♊️ Geminispace JSDoc server
[](https://jsr.io/@arma/geminispace-jsdoc-server)
A [Geminispace](https://geminiquickst.art/) server for serving [JSDoc](https://jsdoc.app/) documentation with the [Deno 2+](https://deno.com/) TypeScript runtime.
## What is Geminispace?
Geminispace is a new Web-like content platform with its own protocol and its own Markdown-like content format. It is especially suitable for browsing content from the terminal. Recommended Gemini client: [amfora](https://github.com/makew0rld/amfora?tab=readme-ov-file#amfora).
## Usage
### 1. Create a TLS certificate and private key
```shell
TLS_CERT=./path/to/cert.pem \
TLS_CERT_KEY=./path/to/key.pem && \
openssl req -x509 -newkey rsa:2048 -keyout $TLS_CERT_KEY -out $TLS_CERT -days 365 -nodes
```
Certificate validity is set to one year by default, and must normally be regenerated periodically.
### 2. Create JSDoc JSON files from the source code
Do this each time the JSDoc in the source code changes:
```shell
deno doc --json --name=MODULENAME ./path/to/mod.mjs > ./path/to/jsdoc/MODULENAME/jsdoc.json
```
The server does not need a restart to serve new content.
Note that the `jsdoc` directory has a strict structure. It can contain:
- a `jsdoc.json` file at the root, and
- any number of module directories, each containing a `jsdoc.json` file.
Additional requirements:
- The `jsdoc` directory can be zero or one directory deep.
- The name `jsdoc.json` is mandatory for the output of `deno doc`.
### 3. Run the JSDoc server
```shell
JSDOC_DIR='./jsdoc' \
TLS_CERT='./cert/cert.pem' \
TLS_CERT_KEY='./cert/key.pem' \
CACHE_SIZE='100' \
HOSTNAME='0.0.0.0' \
PORT='1965' \
deno run --allow-env --allow-net --allow-read \
jsr:@arma/[email protected]/main
```
All environment variables are optional. The command above shows their default values.
`CACHE_SIZE` defines the size of the in-memory cache. 1 means 10 000 bytes. 0 disables the cache.
## Dependencies
This TypeScript module depends on [qgeminiserver](https://github.com/doga/qgeminiserver).
```mermaid
---
title: Dependencies
---
flowchart LR
GeminispaceJSDocServer[geminispace-jsdoc-server] --imports--> QGeminiServer[qgeminiserver]
```
## To do
Current status:
- Only classes, constructors and methods are listed.
- Setter methods are not listed.
## Live servers
These Geminispace capsules are running on `geminispace-jsdoc-server`:
- __Qworum JSDoc server__: [gemini://qworum-jdoc.ddns.net/](gemini://qworum-jdoc.ddns.net/)
To add your capsule here, simply send a pull request.
∎