From 811fa2374f90517c2c50bc86c255e571f42483dd Mon Sep 17 00:00:00 2001 From: Kaliumhexacyanoferrat Date: Tue, 25 Jun 2024 16:02:47 +0200 Subject: [PATCH] Fix broken links --- content/documentation/_index.md | 12 ++++---- .../documentation/content/concepts/_index.md | 6 ++-- .../documentation/content/concepts/caches.md | 2 +- .../content/concepts/definitions.md | 2 +- .../content/concepts/resources.md | 6 ++-- .../concerns/client-caching-validation.md | 2 +- .../content/concerns/compression.md | 2 +- .../documentation/content/concerns/cors.md | 2 +- .../content/concerns/defaults.md | 2 +- .../content/concerns/range-support.md | 4 +-- .../content/concerns/server-caching.md | 16 +++++----- .../documentation/content/handlers/_index.md | 2 +- .../content/handlers/downloads.md | 2 +- .../documentation/content/handlers/listing.md | 4 +-- .../content/handlers/redirects.md | 3 -- .../content/handlers/static-content.md | 9 ++---- content/documentation/content/templates.md | 12 ++++---- content/documentation/hosting/_index.md | 2 +- content/documentation/server/_index.md | 4 +-- .../content/concepts/caches/index.html | 2 +- .../content/concepts/definitions/index.html | 2 +- .../documentation/content/concepts/index.html | 6 ++-- .../documentation/content/concepts/index.xml | 10 +++---- .../content/concepts/resources/index.html | 6 ++-- .../client-caching-validation/index.html | 2 +- .../content/concerns/compression/index.html | 2 +- .../content/concerns/cors/index.html | 2 +- .../content/concerns/defaults/index.html | 2 +- .../documentation/content/concerns/index.xml | 28 ++++++++--------- .../content/concerns/range-support/index.html | 4 +-- .../concerns/server-caching/index.html | 18 +++++------ .../content/handlers/downloads/index.html | 2 +- .../documentation/content/handlers/index.html | 2 +- .../documentation/content/handlers/index.xml | 30 ++++--------------- .../content/handlers/listing/index.html | 8 ++--- .../content/handlers/redirects/index.html | 4 +-- .../handlers/static-content/index.html | 22 ++------------ public/documentation/content/index.xml | 16 +++++----- .../content/templates/index.html | 8 ++--- public/documentation/hosting/index.html | 2 +- public/documentation/index.html | 10 +++---- public/documentation/server/index.html | 4 +-- 42 files changed, 118 insertions(+), 168 deletions(-) diff --git a/content/documentation/_index.md b/content/documentation/_index.md index 7c37312..37f659d 100644 --- a/content/documentation/_index.md +++ b/content/documentation/_index.md @@ -25,12 +25,12 @@ Project templates can be used to create apps for typical use cases with little e To create a project by using the terminal, create a new folder for your app and use one of the following commands: -| Template | Command | Documentation | -|---|---|---| -| REST Webservice | `dotnet new genhttp-webservice` | [Webservices](./content/webservices) | -| REST Webservice (single file) | `dotnet new genhttp-webservice-minimal` | [Functional Handlers](./content/functional) | -| Website (Static HTML) | `dotnet new genhttp-website-static` | [Statics Websites](./content/static-websites) | -| Single Page Application (SPA) | `dotnet new genhttp-spa` | [Single Page Applications (SPA)](./content/single-page-applications) | +| Template | Command | Documentation | +|---|---|---------------------------------------------------------------------------------| +| REST Webservice | `dotnet new genhttp-webservice` | [Webservices](./content/frameworks/webservices) | +| REST Webservice (single file) | `dotnet new genhttp-webservice-minimal` | [Functional Handlers](./content/frameworks/functional) | +| Website (Static HTML) | `dotnet new genhttp-website-static` | [Statics Websites](./content/frameworks/static-websites) | +| Single Page Application (SPA) | `dotnet new genhttp-spa` | [Single Page Applications (SPA)](./content/frameworks/single-page-applications) | After the project has been created, you can run it via `dotnet run` and access the server via http://localhost:8080. diff --git a/content/documentation/content/concepts/_index.md b/content/documentation/content/concepts/_index.md index 63a2f32..07962c5 100644 --- a/content/documentation/content/concepts/_index.md +++ b/content/documentation/content/concepts/_index.md @@ -12,10 +12,10 @@ handlers. {{< cards >}} - {{< card link="./concepts/definitions/" title="Method Definitions" >}} + {{< card link="./definitions/" title="Method Definitions" >}} - {{< card link="./concepts/resources/" title="Resources" >}} + {{< card link="./resources/" title="Resources" >}} - {{< card link="./concepts/caches/" title="Caches" >}} + {{< card link="./caches/" title="Caches" >}} {{< /cards >}} diff --git a/content/documentation/content/concepts/caches.md b/content/documentation/content/concepts/caches.md index efcc032..ceefecb 100644 --- a/content/documentation/content/concepts/caches.md +++ b/content/documentation/content/concepts/caches.md @@ -6,7 +6,7 @@ cascade: type: docs --- -Caches can be used by handlers such as the [cached content](./server-caching) concern +Caches can be used by handlers such as the [cached content](../../concerns/server-caching) concern to store and serve intermediate results for improved performance. The SDK ships with backends for local memory and file system based storage. Custom backends can be provided by implementing the [ICache](https://github.com/Kaliumhexacyanoferrat/GenHTTP/blob/master/API/Content/Caching/ICache.cs) diff --git a/content/documentation/content/concepts/definitions.md b/content/documentation/content/concepts/definitions.md index 18ac776..362a13a 100644 --- a/content/documentation/content/concepts/definitions.md +++ b/content/documentation/content/concepts/definitions.md @@ -549,7 +549,7 @@ for data structures, but also for special types such as streams. Instead of generating a response you can also return an `IHandler` or `IHandlerBuilder` instance. This allows you to provide a whole segment on your web application by re-using the -[existing handlers](../../handlers/) or by implementing [custom ones](../handlers/). +[existing handlers](../../handlers/) or by implementing [custom ones](../../handlers/). The following example will render a fully navigable directory listing view depending on the tenant ID passed to the method: diff --git a/content/documentation/content/concepts/resources.md b/content/documentation/content/concepts/resources.md index bb48659..710ed84 100644 --- a/content/documentation/content/concepts/resources.md +++ b/content/documentation/content/concepts/resources.md @@ -7,7 +7,7 @@ cascade: --- Resources provide an unified way to load and access binary data used by handlers -to achieve their functionality. For example, the [Download](./downloads) handler +to achieve their functionality. For example, the [Download](../../handlers/downloads) handler serves a single file on request - where the content of the file originates from is not important for the handler to achieve it's functionality. @@ -27,8 +27,8 @@ provide resources, for example a database or a cloud blob storage. ## Resource Trees Similar to the resources, resource trees provide an abstraction for a directory -structure that can be consumed by handlers such as the [Directory Browsing](./listing) -or the [Single Page Application](./single-page-applications). +structure that can be consumed by handlers such as the [Directory Browsing](../../handlers/listing) +or the [Single Page Application](../../frameworks/single-page-applications). ```csharp var tree = ResourceTree.FromDirectory("/var/www/downloads/"); // or FromAssembly, ... diff --git a/content/documentation/content/concerns/client-caching-validation.md b/content/documentation/content/concerns/client-caching-validation.md index 6434fdf..d4e48e9 100644 --- a/content/documentation/content/concerns/client-caching-validation.md +++ b/content/documentation/content/concerns/client-caching-validation.md @@ -20,5 +20,5 @@ The `eTag` is generated from the [checksum of the content](https://github.com/Ka that should be served to the client. Dependent on the kind of content (such as a local file resource) the checksum can be calculated quite efficiently. -This concern is part of the [default configuration](./defaults) and will automatically +This concern is part of the [default configuration](../defaults) and will automatically be added to your server. diff --git a/content/documentation/content/concerns/compression.md b/content/documentation/content/concerns/compression.md index e021c2d..fcdd60b 100644 --- a/content/documentation/content/concerns/compression.md +++ b/content/documentation/content/concerns/compression.md @@ -13,7 +13,7 @@ var content = Layout.Create() .Add(CompressedContent.Default()); ``` -This concern is part of the [default configuration](./defaults) and will automatically +This concern is part of the [default configuration](../defaults) and will automatically be added. ## Custom Algorithms diff --git a/content/documentation/content/concerns/cors.md b/content/documentation/content/concerns/cors.md index ad93fe9..6c27924 100644 --- a/content/documentation/content/concerns/cors.md +++ b/content/documentation/content/concerns/cors.md @@ -7,7 +7,7 @@ cascade: [Cross-Origin Resource Sharing](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) allows to control which resources browsers are allowed to access and how they are allowed to do so. For example, if you would like -to access a [webservice](./webservices) from a [website](./websites) hosted on another domain, the browser will +to access a webservice from a website hosted on another domain, the browser will send the `Origin` header along with requests to the webservice and analyze the response to determine, whether the server allows clients to access the resource from this origin. diff --git a/content/documentation/content/concerns/defaults.md b/content/documentation/content/concerns/defaults.md index c34b3b7..c5cae5b 100644 --- a/content/documentation/content/concerns/defaults.md +++ b/content/documentation/content/concerns/defaults.md @@ -7,7 +7,7 @@ cascade: The `Defaults()` method provided by the [Practices](https://www.nuget.org/packages/GenHTTP.Modules.Practices/) module adds some useful concerns to your web server to enable features such as -[compression](./compression) or [client side caching](./client-caching-validation). +[compression](../compression) or [client side caching](../client-caching-validation). This way, you will have a well configured server instance without the need of adding everything by yourself. diff --git a/content/documentation/content/concerns/range-support.md b/content/documentation/content/concerns/range-support.md index 83c4fb7..ab496f9 100644 --- a/content/documentation/content/concerns/range-support.md +++ b/content/documentation/content/concerns/range-support.md @@ -12,7 +12,7 @@ needed by every web application, [range support](https://developer.mozilla.org/e disabled by default. To enable this feature on server level, you may pass an -additional flag to the [default configuration](./defaults). +additional flag to the [default configuration](../defaults). ```csharp Host.Create() @@ -26,7 +26,7 @@ to be requested (which would then result in a multipart response). ## Scope -As the range support is implemented as a [concern](../concepts/concerns.md), you +As the range support is implemented as a [concern](../), you may add this functionality to any handler as needed. ```csharp diff --git a/content/documentation/content/concerns/server-caching.md b/content/documentation/content/concerns/server-caching.md index b5e90c0..0f13d58 100644 --- a/content/documentation/content/concerns/server-caching.md +++ b/content/documentation/content/concerns/server-caching.md @@ -7,15 +7,15 @@ cascade: This concern allows to cache responses generated by a handler and to serve them from the cache when they are requested again. The following -example will cache all responses generated by a [website](./websites): +example will cache all responses generated by an API: ```csharp -var website = Website.Create() - .Content(...) - .Add(ServerCache.Memory()); +var service = Layout.Create() + .Content(...) + .Add(ServerCache.Memory()); Host.Create() - .Handler(website) + .Handler(service) .Console() .Defaults() .Run(); @@ -24,7 +24,7 @@ Host.Create() ## When to Cache Caching usually introduces some overhead that might affect the performance -of your web application in a negative manner. A cache will boost the +of your application in a negative manner. A cache will boost the performance of your application if the provided content does rarely change and the generation of the content is expensive. @@ -35,7 +35,7 @@ application instead. ## Backends The server cache can utilize any backend provided by the -[cache infrastructure](./caches). +[cache infrastructure](../../concepts/caches). ```csharp // uses RAM to cache generated responses @@ -110,7 +110,7 @@ var cache = ServerCache.Create(meta, data); ## Pre-compress Content -Typically, the [compression](./compression) concern is added to +Typically, the [compression](../compression) concern is added to dynamically compress the content which is generated by your web application. If the content of your application is rather static, you can use the server cache to compress the content once with diff --git a/content/documentation/content/handlers/_index.md b/content/documentation/content/handlers/_index.md index 4a5f029..527b362 100644 --- a/content/documentation/content/handlers/_index.md +++ b/content/documentation/content/handlers/_index.md @@ -7,7 +7,7 @@ cascade: --- Handlers are responsible for analyzing HTTP requests and to serve responses to the connected client. All features -available in the SDK are either provided by handlers or [concerns](./concerns). +available in the SDK are either provided by handlers or [concerns](../concerns). If you would like to add an additional feature that cannot be achieved using the existing functionality to the SDK or your own web application, you may implement diff --git a/content/documentation/content/handlers/downloads.md b/content/documentation/content/handlers/downloads.md index a8b6dc2..4fdb98d 100644 --- a/content/documentation/content/handlers/downloads.md +++ b/content/documentation/content/handlers/downloads.md @@ -5,7 +5,7 @@ cascade: type: docs --- -Downloads allow to serve a single [Resource](./resources) with a fixed name to your clients. The content type +Downloads allow to serve a single [Resource](../../concepts/resources) with a fixed name to your clients. The content type of the file will automatically be determined by it's extension. ```csharp diff --git a/content/documentation/content/handlers/listing.md b/content/documentation/content/handlers/listing.md index 45e1eab..e95546d 100644 --- a/content/documentation/content/handlers/listing.md +++ b/content/documentation/content/handlers/listing.md @@ -6,7 +6,7 @@ cascade: --- The directory listing provider serves a simple web UI allowing users to browse directories -and files read from a [resource tree](../concepts/resources.md) below the specified path. +and files read from a [resource tree](../../concepts/resources) below the specified path. ```csharp var tree = ResourceTree.FromDirectory("/var/www/documents/"); @@ -17,7 +17,5 @@ Host.Create() ``` In this example, the listing view will be available at http://localhost:8080/. -The generated view will be rendered using the template of the [Website](./websites) -the provider is embedded into (or the server theme by default). ![Directory listing served by the GenHTTP server](listing.png) diff --git a/content/documentation/content/handlers/redirects.md b/content/documentation/content/handlers/redirects.md index fce3881..8a7b9f6 100644 --- a/content/documentation/content/handlers/redirects.md +++ b/content/documentation/content/handlers/redirects.md @@ -17,6 +17,3 @@ Host.Create() In this example, accessing http://localhost:8080 will redirect the client to the Google search engine. By default, the HTTP status 301 (permament redirect) will be sent, which can get customized to a temporary HTTP 307 redirect. - -If you would like to redirect the client to a resource that is hosted by your -application, you can also pass a symbolic route such as `{sitemap}` (see [routing](./websites#routing)). diff --git a/content/documentation/content/handlers/static-content.md b/content/documentation/content/handlers/static-content.md index e832647..1dec17f 100644 --- a/content/documentation/content/handlers/static-content.md +++ b/content/documentation/content/handlers/static-content.md @@ -5,7 +5,7 @@ cascade: type: docs --- -To provide static resources required by your web application, add them to your project +To provide static resources required by your application, add them to your project and mark them either as `Content` or as an `Embedded Resource`. To serve those files, you can use the `Resources` factory class: @@ -26,9 +26,4 @@ Host.Create() ``` For example, a stylesheet named `main.css` in the `styles` subfolder would be made available at -http://localhost:8080/res/styles/main.css. To generate a relative link to the file, use the routing -functionality from within your template: - -```html -{{ route 'res/styles/main.css' }} -``` +http://localhost:8080/res/styles/main.css. diff --git a/content/documentation/content/templates.md b/content/documentation/content/templates.md index 45e5e4a..f8ccaf6 100644 --- a/content/documentation/content/templates.md +++ b/content/documentation/content/templates.md @@ -31,12 +31,12 @@ be used from there to quickly create new projects: The following templates are available to be used: -| Template | Description | -|------------------------------|------------- | -| `genhttp-webservice` | A project that will host a new [REST web service](./webservices). | -| `genhttp-webservice-minimal` | A project that will host a minimal web service in a single file using the [functional module](./functional). | -| `genhttp-website-static` | Serves a [static website](./static-websites) from the file system. | -| `genhttp-spa` | Serves the distribution files of a [Single Page Application (SPA)](./single-page-applications). | +| Template | Description | +|------------------------------|--------------------------------------------------------------------------------------------------------------------------| +| `genhttp-webservice` | A project that will host a new [REST web service](../frameworks/webservices). | +| `genhttp-webservice-minimal` | A project that will host a minimal web service in a single file using the [functional module](../frameworks/functional). | +| `genhttp-website-static` | Serves a [static website](../frameworks/static-websites) from the file system. | +| `genhttp-spa` | Serves the distribution files of a [Single Page Application (SPA)](../frameworks/single-page-applications). | After creating the project, you can run it with `dotnet run` which make the application available on [http://localhost:8080](http://localhost:8080). diff --git a/content/documentation/hosting/_index.md b/content/documentation/hosting/_index.md index e83b202..3df05f3 100644 --- a/content/documentation/hosting/_index.md +++ b/content/documentation/hosting/_index.md @@ -16,7 +16,7 @@ see their [Docker Hub](https://hub.docker.com/_/microsoft-dotnet-core-sdk/) page ## Building Template Apps -If you created your application using a [project template](../documentation/templates), +If you created your application using a [project template](../content/templates), you will see that matching Docker files have already been created. Building and running your app is as easy as: diff --git a/content/documentation/server/_index.md b/content/documentation/server/_index.md index 8bf6f6f..4e8463b 100644 --- a/content/documentation/server/_index.md +++ b/content/documentation/server/_index.md @@ -44,8 +44,8 @@ for service mocks in integration and component testing as well. By default, the server will listen to all IP addresses on port 8080. These settings can be adjusted [as needed](./endpoints). The `Defaults()` call adds -[typical features](/documentation/content/defaults) such as [compression](/documentation/content/compression) -and [client caching](/documentation/content/client-caching-validation). +[typical features](/documentation/content/concerns/defaults) such as [compression](/documentation/content/concerns/compression) +and [client caching](/documentation/content/concerns/client-caching-validation). ## Security diff --git a/public/documentation/content/concepts/caches/index.html b/public/documentation/content/concepts/caches/index.html index 4340378..b0e9ed9 100644 --- a/public/documentation/content/concepts/caches/index.html +++ b/public/documentation/content/concepts/caches/index.html @@ -882,7 +882,7 @@

Caches

-

Caches can be used by handlers such as the cached content concern +

Caches can be used by handlers such as the cached content concern to store and serve intermediate results for improved performance. The SDK ships with backends for local memory and file system based storage. Custom backends can be provided by implementing the ICache diff --git a/public/documentation/content/concepts/definitions/index.html b/public/documentation/content/concepts/definitions/index.html index b79b18e..674e4b7 100644 --- a/public/documentation/content/concepts/definitions/index.html +++ b/public/documentation/content/concepts/definitions/index.html @@ -2627,7 +2627,7 @@

Results

Handlers

Instead of generating a response you can also return an IHandler or IHandlerBuilder instance. This allows you to provide a whole segment on your web application by re-using the -existing handlers or by implementing custom ones.

+existing handlers or by implementing custom ones.

The following example will render a fully navigable directory listing view depending on the tenant ID passed to the method:

-
- - -
+http://localhost:8080/res/styles/main.css.

diff --git a/public/documentation/content/index.xml b/public/documentation/content/index.xml index bd6ef81..fd0f917 100644 --- a/public/documentation/content/index.xml +++ b/public/documentation/content/index.xml @@ -76,19 +76,19 @@ be used from there to quickly create new projects:</p> <tbody> <tr> <td><code>genhttp-webservice</code></td> -<td>A project that will host a new <a href="./webservices" >REST web service</a>.</td> +<td>A project that will host a new <a href="../frameworks/webservices" >REST web service</a>.</td> </tr> <tr> <td><code>genhttp-webservice-minimal</code></td> -<td>A project that will host a minimal web service in a single file using the <a href="./functional" >functional module</a>.</td> +<td>A project that will host a minimal web service in a single file using the <a href="../frameworks/functional" >functional module</a>.</td> </tr> <tr> <td><code>genhttp-website-static</code></td> -<td>Serves a <a href="./static-websites" >static website</a> from the file system.</td> +<td>Serves a <a href="../frameworks/static-websites" >static website</a> from the file system.</td> </tr> <tr> <td><code>genhttp-spa</code></td> -<td>Serves the distribution files of a <a href="./single-page-applications" >Single Page Application (SPA)</a>.</td> +<td>Serves the distribution files of a <a href="../frameworks/single-page-applications" >Single Page Application (SPA)</a>.</td> </tr> </tbody> </table> @@ -166,7 +166,7 @@ such as providing a RESTful service API.</p> <p>Handlers are responsible for analyzing HTTP requests and to serve responses to the connected client. All features -available in the SDK are either provided by handlers or <a href="./concerns" >concerns</a>.</p> +available in the SDK are either provided by handlers or <a href="../concerns" >concerns</a>.</p> <p>If you would like to add an additional feature that cannot be achieved using the existing functionality to the SDK or your own web application, you may implement a custom handler instance. The following example will generate a simple text response:</p> @@ -338,15 +338,15 @@ handlers.</p> <a href="#concepts" class="subheading-anchor" aria-label="Permalink for this section"></a></h2><div class="hextra-cards hx-mt-4 hx-gap-4 hx-grid not-prose" style="--hextra-cards-grid-cols: 3;"> <a - class="hextra-card hx-group hx-flex hx-flex-col hx-justify-start hx-overflow-hidden hx-rounded-lg hx-border hx-border-gray-200 hx-text-current hx-no-underline dark:hx-shadow-none hover:hx-shadow-gray-100 dark:hover:hx-shadow-none hx-shadow-gray-100 active:hx-shadow-sm active:hx-shadow-gray-200 hx-transition-all hx-duration-200 hover:hx-border-gray-300 hx-bg-transparent hx-shadow-sm dark:hx-border-neutral-800 hover:hx-bg-slate-50 hover:hx-shadow-md dark:hover:hx-border-neutral-700 dark:hover:hx-bg-neutral-900"href="./concepts/definitions/" + class="hextra-card hx-group hx-flex hx-flex-col hx-justify-start hx-overflow-hidden hx-rounded-lg hx-border hx-border-gray-200 hx-text-current hx-no-underline dark:hx-shadow-none hover:hx-shadow-gray-100 dark:hover:hx-shadow-none hx-shadow-gray-100 active:hx-shadow-sm active:hx-shadow-gray-200 hx-transition-all hx-duration-200 hover:hx-border-gray-300 hx-bg-transparent hx-shadow-sm dark:hx-border-neutral-800 hover:hx-bg-slate-50 hover:hx-shadow-md dark:hover:hx-border-neutral-700 dark:hover:hx-bg-neutral-900"href="./definitions/" ><span class="hextra-card-icon hx-flex hx-font-semibold hx-items-start hx-gap-2 hx-p-4 hx-text-gray-700 hover:hx-text-gray-900 dark:hx-text-neutral-200 dark:hover:hx-text-neutral-50">Method Definitions</span></a> <a - class="hextra-card hx-group hx-flex hx-flex-col hx-justify-start hx-overflow-hidden hx-rounded-lg hx-border hx-border-gray-200 hx-text-current hx-no-underline dark:hx-shadow-none hover:hx-shadow-gray-100 dark:hover:hx-shadow-none hx-shadow-gray-100 active:hx-shadow-sm active:hx-shadow-gray-200 hx-transition-all hx-duration-200 hover:hx-border-gray-300 hx-bg-transparent hx-shadow-sm dark:hx-border-neutral-800 hover:hx-bg-slate-50 hover:hx-shadow-md dark:hover:hx-border-neutral-700 dark:hover:hx-bg-neutral-900"href="./concepts/resources/" + class="hextra-card hx-group hx-flex hx-flex-col hx-justify-start hx-overflow-hidden hx-rounded-lg hx-border hx-border-gray-200 hx-text-current hx-no-underline dark:hx-shadow-none hover:hx-shadow-gray-100 dark:hover:hx-shadow-none hx-shadow-gray-100 active:hx-shadow-sm active:hx-shadow-gray-200 hx-transition-all hx-duration-200 hover:hx-border-gray-300 hx-bg-transparent hx-shadow-sm dark:hx-border-neutral-800 hover:hx-bg-slate-50 hover:hx-shadow-md dark:hover:hx-border-neutral-700 dark:hover:hx-bg-neutral-900"href="./resources/" ><span class="hextra-card-icon hx-flex hx-font-semibold hx-items-start hx-gap-2 hx-p-4 hx-text-gray-700 hover:hx-text-gray-900 dark:hx-text-neutral-200 dark:hover:hx-text-neutral-50">Resources</span></a> <a - class="hextra-card hx-group hx-flex hx-flex-col hx-justify-start hx-overflow-hidden hx-rounded-lg hx-border hx-border-gray-200 hx-text-current hx-no-underline dark:hx-shadow-none hover:hx-shadow-gray-100 dark:hover:hx-shadow-none hx-shadow-gray-100 active:hx-shadow-sm active:hx-shadow-gray-200 hx-transition-all hx-duration-200 hover:hx-border-gray-300 hx-bg-transparent hx-shadow-sm dark:hx-border-neutral-800 hover:hx-bg-slate-50 hover:hx-shadow-md dark:hover:hx-border-neutral-700 dark:hover:hx-bg-neutral-900"href="./concepts/caches/" + class="hextra-card hx-group hx-flex hx-flex-col hx-justify-start hx-overflow-hidden hx-rounded-lg hx-border hx-border-gray-200 hx-text-current hx-no-underline dark:hx-shadow-none hover:hx-shadow-gray-100 dark:hover:hx-shadow-none hx-shadow-gray-100 active:hx-shadow-sm active:hx-shadow-gray-200 hx-transition-all hx-duration-200 hover:hx-border-gray-300 hx-bg-transparent hx-shadow-sm dark:hx-border-neutral-800 hover:hx-bg-slate-50 hover:hx-shadow-md dark:hover:hx-border-neutral-700 dark:hover:hx-bg-neutral-900"href="./caches/" ><span class="hextra-card-icon hx-flex hx-font-semibold hx-items-start hx-gap-2 hx-p-4 hx-text-gray-700 hover:hx-text-gray-900 dark:hx-text-neutral-200 dark:hover:hx-text-neutral-50">Caches</span></a> </div> diff --git a/public/documentation/content/templates/index.html b/public/documentation/content/templates/index.html index 506cfd6..cfb1d68 100644 --- a/public/documentation/content/templates/index.html +++ b/public/documentation/content/templates/index.html @@ -944,19 +944,19 @@

Templates

genhttp-webservice -A project that will host a new REST web service. +A project that will host a new REST web service. genhttp-webservice-minimal -A project that will host a minimal web service in a single file using the functional module. +A project that will host a minimal web service in a single file using the functional module. genhttp-website-static -Serves a static website from the file system. +Serves a static website from the file system. genhttp-spa -Serves the distribution files of a Single Page Application (SPA). +Serves the distribution files of a Single Page Application (SPA). diff --git a/public/documentation/hosting/index.html b/public/documentation/hosting/index.html index 01f4180..6092e43 100644 --- a/public/documentation/hosting/index.html +++ b/public/documentation/hosting/index.html @@ -924,7 +924,7 @@

Hosting with DockerDocker Hub page.

Building Template Apps -

If you created your application using a project template, +

If you created your application using a project template, you will see that matching Docker files have already been created. Building and running your app is as easy as:

diff --git a/public/documentation/index.html b/public/documentation/index.html index 8024ba4..6261f46 100644 --- a/public/documentation/index.html +++ b/public/documentation/index.html @@ -88,7 +88,7 @@ title="Documentation" href="/documentation" - class="hx-text-sm contrast-more:hx-text-gray-700 contrast-more:dark:hx-text-gray-100 hx-relative -hx-ml-2 hx-hidden hx-whitespace-nowrap hx-p-2 md:hx-inline-block hx-font-medium" + class="hx-text-sm contrast-more:hx-text-gray-700 contrast-more:dark:hx-text-gray-100 hx-relative -hx-ml-2 hx-hidden hx-whitespace-nowrap hx-p-2 md:hx-inline-block hx-text-gray-600 hover:hx-text-gray-800 dark:hx-text-gray-400 dark:hover:hx-text-gray-200" > Documentation New Project REST Webservice dotnet new genhttp-webservice -Webservices +Webservices REST Webservice (single file) dotnet new genhttp-webservice-minimal -Functional Handlers +Functional Handlers Website (Static HTML) dotnet new genhttp-website-static -Statics Websites +Statics Websites Single Page Application (SPA) dotnet new genhttp-spa -Single Page Applications (SPA) +Single Page Applications (SPA) diff --git a/public/documentation/server/index.html b/public/documentation/server/index.html index 1ae7c07..0738d1a 100644 --- a/public/documentation/server/index.html +++ b/public/documentation/server/index.html @@ -943,8 +943,8 @@

Server Lifecycle

for service mocks in integration and component testing as well.

By default, the server will listen to all IP addresses on port 8080. These settings can be adjusted as needed. The Defaults() call adds -typical features such as compression -and client caching.

+typical features such as compression +and client caching.

Security

By default, the server will provide an HTTP endpoint on port 8080 with no SSL supported enabled. It is recommended to serve all of your web applications