Skip to content

Commit 3ab9c84

Browse files
committed
Add README.md & NuGet properties
1 parent 53521f2 commit 3ab9c84

2 files changed

Lines changed: 64 additions & 1 deletion

File tree

src/OrchardCoreContrib.Apis.Scalar/OrchardCoreContrib.Apis.Scalar.csproj

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,34 @@
11
<Project Sdk="Microsoft.NET.Sdk">
22

33
<PropertyGroup>
4-
<ImplicitUsings>enable</ImplicitUsings>
4+
<VersionPrefix>1.0.0</VersionPrefix>
5+
<Authors>The Orchard Core Contrib Team</Authors>
6+
<Company />
7+
<Description>Enables Scalar UI for Orchard Core APIs.</Description>
8+
<PackageReadmeFile>README.md</PackageReadmeFile>
9+
<PackageLicenseExpression>BSD-3-Clause</PackageLicenseExpression>
10+
<PackageProjectUrl>https://github.com/OrchardCoreContrib/OrchardCoreContrib.Modules/tree/main/src/OrchardCoreContrib.Apis.Scalar/README.md</PackageProjectUrl>
11+
<RepositoryUrl>https://github.com/OrchardCoreContrib/OrchardCoreContrib.Modules</RepositoryUrl>
12+
<RepositoryType>git</RepositoryType>
13+
<PublishRepositoryUrl>true</PublishRepositoryUrl>
14+
<PackageTags>Orchard Core, Orchard Core Contrib, OpenAPI, Swagger, Scalar UI</PackageTags>
15+
<PackageReleaseNotes>https://github.com/OrchardCoreContrib/OrchardCoreContrib.Modules/releases</PackageReleaseNotes>
16+
<PackageId>OrchardCoreContrib.Apis.Scalar</PackageId>
17+
<PackageIcon>icon.png</PackageIcon>
18+
<Product>Orchard Core Contrib Scalar Module</Product>
19+
<PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
20+
<Copyright>2019 Orchard Core Contrib</Copyright>
521
</PropertyGroup>
622

723
<ItemGroup>
824
<FrameworkReference Include="Microsoft.AspNetCore.App" />
925
</ItemGroup>
1026

27+
<ItemGroup>
28+
<None Include="../../images/icon.png" Pack="true" PackagePath="icon.png" />
29+
<None Include="README.md" Pack="true" PackagePath="\"/>
30+
</ItemGroup>
31+
1132
<ItemGroup>
1233
<PackageReference Include="OrchardCoreContrib.OpenApi.Abstractions" />
1334
<PackageReference Include="OrchardCore.Module.Targets" />
Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# Scalar Module
2+
3+
This module allows you to create APIs documentations using Scalar UI.
4+
5+
## Version
6+
7+
1.0.0
8+
9+
## Category
10+
11+
Api
12+
13+
## Dependencies
14+
15+
| Product | Module |
16+
|-------------|-----------------------------|
17+
| OrchardCoreContrib | Swagger (`OrchardCoreContrib.Api.Swagger`) |
18+
19+
## Features
20+
21+
| | |
22+
|------------------|---------------------------------------------|
23+
| **Name** | Scalar (`OrchardCoreContrib.Apis.Scalar`) |
24+
| **Description** | Enables Scalar UI for OrchardCore APIs. |
25+
| **Dependencies** | |
26+
27+
## NuGet Packages
28+
29+
| Name | Version |
30+
|-----------------------------------------------------------------------------------------------------------|---------|
31+
| [`OrchardCoreContrib.Apis.Scalar`](https://www.nuget.org/packages/OrchardCoreContrib.Apis.Scalar/1.0.0) | 1.0.0 |
32+
33+
## Get Started
34+
35+
1. Install the [`OrchardCoreContrib.Apis.Scalar`](https://www.nuget.org/packages/OrchardCoreContrib.Apis.Scalar/) NuGet package to your Orchard Core host project.
36+
2. Go to the admin site
37+
3. Select **Configuration -> Features** menu.
38+
39+
### Scalar UI
40+
41+
4. Enable the `Scalar UI` feature.
42+
5. Go to the `{tenant-URL}/scalar`, you should see all the APIs listed in Scalar UI docs.

0 commit comments

Comments
 (0)