mirror of https://github.com/abpframework/abp.git
Alper Ebicoglu
8 years ago
639 changed files with 681 additions and 121 deletions
@ -0,0 +1,146 @@ |
|||
# VoloDocs |
|||
|
|||
## What is VoloDocs? |
|||
|
|||
VoloDocs is a cross-platform web application that allows you to easily create beautiful documentation and build developer communities. It simplifies software documentation with the help of GitHub integration. You use the power of GitHub for versioning, hosting of your docs. You let your users to edit a document. |
|||
|
|||
## Main Features |
|||
|
|||
- Serves documents from your GitHub repository. |
|||
- Supports Markdown / HTML document formatting. |
|||
- Supports versioning (integrated to GitHub releases). |
|||
- Support multiple projects. |
|||
- Allows users to edit a document on GitHub. |
|||
- Cross-platform; deployable to Windows / Linux / macOS. |
|||
|
|||
## GitHub Repository |
|||
|
|||
It's free & open-source. You can browse VoloDocs source-code and contribute on GitHub: |
|||
|
|||
https://github.com/abpframework/abp/tree/master/modules/docs |
|||
|
|||
## Download |
|||
|
|||
You can download the VoloDocs release from the following link: |
|||
|
|||
http://apps.abp.io/VoloDocs/VoloDocs.zip |
|||
|
|||
## Folder Structure |
|||
|
|||
When you extract the VoloDocs.Release zip file, you see a `Web` folder and a `Migrator` folder. `Web` folder contains the website files and `Migrator` contains the application to build your database. Before publishing your website, you need to create a new database or update your existing database to the latest. If this is the first time you install VoloDocs, `Migrator` will create a new database for you, otherwise it updates to the latest version. The only setting you need to configure, is the `ConnectionString` which is located in the `appsettings.json` file. See the next section for how to configure your VoloDocs application. |
|||
|
|||
## Steps by Step Deployment |
|||
|
|||
- ### Database Migration |
|||
|
|||
To update your existing database or create your initial database, go to `Migrator` folder in your VoloDocs directory. |
|||
|
|||
Open `appsettings.json` in your text editor and set your database connection string. If you don't know how to write the connection string for your database system, you can check out https://www.connectionstrings.com/. |
|||
|
|||
After you set your connection string, run `Migrate.bat` for Windows platform and `VoloDocs.Migrator` for other operating systems. That's it now configure your website. |
|||
|
|||
- ### Configuring Website |
|||
|
|||
Go to `Web` folder in your VoloDocs directory. Open `appsettings.json` in your text editor. Set your connection string (same as in the `Migrator`'s `appsettings.json`). Set `title` of your website. This will be written on the left-upper corner of your website. That's it! Now you can publish your website. |
|||
|
|||
If you want to run |
|||
|
|||
- ### Publishing Website |
|||
|
|||
In the previous step, you created or updated your database. Ensure that your database exists on the specified connection string. |
|||
|
|||
- #### Publishing to IIS |
|||
|
|||
- Move `Web` folder to your `wwwroot ` folder. |
|||
- Rename `Web` folder to `VoloDocs` (Now you have `C:\inetpub\wwwroot\VoloDocs`). |
|||
- The `VoloDocs` application pool is being created automatically. Open **Application Pools** and double click `VoloDocs` application pool and set |
|||
- **.NET CLR version**: `No Managed Code` |
|||
- **Managed pipeline mode**: `Integrated` |
|||
|
|||
 |
|||
|
|||
|
|||
|
|||
- If you get the below error, it means don't have the hosting bundle installed on the server. See [this document](https://docs.microsoft.com/aspnet/core/host-and-deploy/iis/#install-the-net-core-hosting-bundle) to learn how to install it or [download Hosting Bundle](https://www.microsoft.com/net/permalink/dotnetcore-current-windows-runtime-bundle-installer) and run on your server. |
|||
|
|||
``` |
|||
Handler "aspNetCore" has a bad module "AspNetCoreModuleV2" in its module list using IIS |
|||
``` |
|||
|
|||
- Further information about hosting VoloDocs check out [Microsoft's official document for hosting ASP.NET Core application on IIS](https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis). |
|||
|
|||
- #### Publishing to Azure |
|||
|
|||
Microsoft has a good document on how to deploy your ASP.NET Core web app to Azure App Service. We recommend you to read this document https://docs.microsoft.com/en-us/azure/app-service/app-service-web-get-started-dotnet. |
|||
|
|||
- #### Running the Application From Command Line |
|||
|
|||
Alternatively you can run the application from command line, navigate to `VoloDocs\Web` folder and run the below command in your command line for Windows: |
|||
|
|||
```powershell |
|||
dotnet VoloDocs.Web.dll |
|||
``` |
|||
|
|||
- ### First Run |
|||
|
|||
To start the website, navigate to your address (as configured in the previous section). |
|||
|
|||
When you first open the website, you need to create a project. |
|||
|
|||
#### Creating a Project |
|||
|
|||
Go to the following address to create project |
|||
|
|||
- `http://<yourwebsite>/Account/Login?returnUrl=/Docs/Admin/Projects` |
|||
|
|||
##### Default credentials |
|||
|
|||
To login the admin side, use the following credentials: |
|||
|
|||
* **Username**: `admin` |
|||
|
|||
* **Password**: `1q2w3E*` |
|||
|
|||
##### An example project definition |
|||
|
|||
Here's a sample project information that uses GitHub source. |
|||
|
|||
We will configure the VoloDocs to show ABP Framework's documentation that's stored in GitHub. |
|||
|
|||
Here's the link to ABP Framework GitHub docs folder: |
|||
|
|||
https://github.com/abpframework/abp/tree/master/docs/en |
|||
|
|||
|
|||
|
|||
* **Name**: `ABP Framework` |
|||
|
|||
* **Short name**: `abp` |
|||
|
|||
* **Format**: `markdown` |
|||
|
|||
* **Default document name**: `Index` |
|||
|
|||
* **Navigation document name**: `docs-nav.json` |
|||
|
|||
* **Minimum version**: <empty> |
|||
|
|||
* **Main web site URL**: / |
|||
|
|||
* **Latest version branch name**: <empty> |
|||
|
|||
* **GitHub root URL**: `https://github.com/abpframework/abp/tree/{version}/docs/en/` |
|||
|
|||
* **GitHub access token**: <retrieve from GitHub> |
|||
|
|||
* **GitHub user agent**: <your username> |
|||
|
|||
|
|||
|
|||
After you save the project, go to root website address and you will see your documentation. |
|||
|
|||
* `http://<yourwebsite>/documents` |
|||
|
|||
|
|||
|
|||
|
|||
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 5.9 KiB |
@ -1,4 +0,0 @@ |
|||
@page |
|||
@model Volo.DocsTestApp.Pages.IndexModel |
|||
<h3>Welcome to the Docs Demo!</h3> |
|||
<a href="/documents/">Go to documents...</a> |
|||
@ -1,16 +0,0 @@ |
|||
using System; |
|||
using System.Collections.Generic; |
|||
using System.Linq; |
|||
using System.Threading.Tasks; |
|||
using Microsoft.AspNetCore.Mvc; |
|||
using Microsoft.AspNetCore.Mvc.RazorPages; |
|||
|
|||
namespace Volo.DocsTestApp.Pages |
|||
{ |
|||
public class IndexModel : PageModel |
|||
{ |
|||
public void OnGet() |
|||
{ |
|||
} |
|||
} |
|||
} |
|||
@ -1,6 +0,0 @@ |
|||
{ |
|||
"ConnectionStrings": { |
|||
"SqlServer": "Server=localhost;Database=DocsTestApp;Trusted_Connection=True;MultipleActiveResultSets=true", |
|||
"MongoDb": "mongodb://localhost:27017|DocsTestApp" |
|||
} |
|||
} |
|||
@ -1,7 +1,7 @@ |
|||
using System; |
|||
using Microsoft.EntityFrameworkCore.Migrations; |
|||
|
|||
namespace Volo.DocsTestApp.EntityFrameworkCore.Migrations |
|||
namespace VoloDocs.EntityFrameworkCore.Migrations |
|||
{ |
|||
public partial class Initial20181225 : Migration |
|||
{ |
|||
@ -0,0 +1,13 @@ |
|||
using Microsoft.Extensions.DependencyInjection; |
|||
using Volo.Abp; |
|||
|
|||
namespace VoloDocs.Migrator |
|||
{ |
|||
public static class AppExtensions |
|||
{ |
|||
public static T Resolve<T>(this IAbpApplicationWithInternalServiceProvider app) |
|||
{ |
|||
return (T)app.ServiceProvider.GetRequiredService<T>(); |
|||
} |
|||
} |
|||
} |
|||
@ -0,0 +1 @@ |
|||
@dotnet VoloDocs.Migrator.dll |
|||
@ -0,0 +1,94 @@ |
|||
using System; |
|||
using System.IO; |
|||
using System.Linq; |
|||
using Microsoft.EntityFrameworkCore; |
|||
using Volo.Abp; |
|||
using VoloDocs.EntityFrameworkCore; |
|||
|
|||
namespace VoloDocs.Migrator |
|||
{ |
|||
class Program |
|||
{ |
|||
private const string ScriptFile = "Script.txt"; |
|||
|
|||
static void Main(string[] args) |
|||
{ |
|||
Console.WriteLine("Initializing VoloDocs Migrator ... "); |
|||
|
|||
using (var app = AbpApplicationFactory.Create<VoloDocsMigratorModule>()) |
|||
{ |
|||
app.Initialize(); |
|||
|
|||
using (var dbContext = app.Resolve<VoloDocsDbContext>()) |
|||
{ |
|||
var connectionString = dbContext.Database.GetDbConnection().ConnectionString; |
|||
|
|||
Console.Clear(); |
|||
|
|||
if (args != null && args.Contains("-script")) |
|||
{ |
|||
GenerateMigrationScript(dbContext); |
|||
return; |
|||
} |
|||
|
|||
RunMigrations(connectionString, dbContext); |
|||
} |
|||
|
|||
Console.WriteLine("\n\nPress ENTER to exit..."); |
|||
Console.ReadLine(); |
|||
} |
|||
} |
|||
|
|||
private static void RunMigrations(string connectionString, VoloDocsDbContext dbContext) |
|||
{ |
|||
Console.Write("\nThis program updates an existing database or creates a new one if not exists.\n" + |
|||
"The following connection string will be used:\n\n" + |
|||
connectionString + "\n\n" + |
|||
"Are you sure you want to run the migration? (y/n) "); |
|||
|
|||
if (Console.ReadKey().Key == ConsoleKey.Y) |
|||
{ |
|||
Console.WriteLine("\n\nMigrating database..."); |
|||
|
|||
try |
|||
{ |
|||
dbContext.Database.Migrate(); |
|||
|
|||
Console.WriteLine("Migration completed."); |
|||
} |
|||
catch (Exception ex) |
|||
{ |
|||
Console.WriteLine(ex.Message); |
|||
|
|||
while (ex.InnerException != null) |
|||
{ |
|||
ex = ex.InnerException; |
|||
Console.WriteLine(ex.Message); |
|||
} |
|||
|
|||
Console.Write("\nThere was problem while applying migrations. " + |
|||
"Do you want to create the migration script? (y/n) "); |
|||
|
|||
if (Console.ReadKey().Key == ConsoleKey.Y) |
|||
{ |
|||
GenerateMigrationScript(dbContext); |
|||
} |
|||
} |
|||
} |
|||
} |
|||
|
|||
private static void GenerateMigrationScript(VoloDocsDbContext dbContext) |
|||
{ |
|||
if (File.Exists(ScriptFile)) |
|||
{ |
|||
File.Delete(ScriptFile); |
|||
} |
|||
|
|||
Console.Write("\nGenerating migration scripts..."); |
|||
|
|||
File.WriteAllText(ScriptFile, dbContext.Database.GenerateCreateScript()); |
|||
|
|||
Console.Write("\nMigration script has been created to Script.txt file"); |
|||
} |
|||
} |
|||
} |
|||
@ -0,0 +1,27 @@ |
|||
<Project Sdk="Microsoft.NET.Sdk"> |
|||
|
|||
<PropertyGroup> |
|||
<OutputType>Exe</OutputType> |
|||
<TargetFramework>netcoreapp2.2</TargetFramework> |
|||
<RuntimeIdentifiers>win-x64;linux-x64;osx-x64</RuntimeIdentifiers> |
|||
</PropertyGroup> |
|||
|
|||
<ItemGroup> |
|||
<ProjectReference Include="..\..\..\..\framework\src\Volo.Abp.Core\Volo.Abp.Core.csproj" /> |
|||
<ProjectReference Include="..\VoloDocs.EntityFrameworkCore\VoloDocs.EntityFrameworkCore.csproj" /> |
|||
</ItemGroup> |
|||
|
|||
<ItemGroup> |
|||
<Content Include="appsettings.json"> |
|||
<CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory> |
|||
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory> |
|||
</Content> |
|||
</ItemGroup> |
|||
|
|||
<ItemGroup> |
|||
<None Update="Migrate.bat"> |
|||
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory> |
|||
</None> |
|||
</ItemGroup> |
|||
|
|||
</Project> |
|||
@ -0,0 +1,29 @@ |
|||
using Microsoft.Extensions.DependencyInjection; |
|||
using Volo.Abp.Data; |
|||
using Volo.Abp.EntityFrameworkCore; |
|||
using Volo.Abp.Modularity; |
|||
using VoloDocs.EntityFrameworkCore; |
|||
|
|||
namespace VoloDocs.Migrator |
|||
{ |
|||
[DependsOn(typeof(VoloDocsEntityFrameworkCoreModule))] |
|||
public class VoloDocsMigratorModule : AbpModule |
|||
{ |
|||
public override void ConfigureServices(ServiceConfigurationContext context) |
|||
{ |
|||
var configuration = context.Services.GetConfiguration(); |
|||
|
|||
context.Services.AddAbpDbContext<VoloDocsDbContext>(); |
|||
|
|||
Configure<DbConnectionOptions>(options => |
|||
{ |
|||
options.ConnectionStrings.Default = configuration["ConnectionString"]; |
|||
}); |
|||
|
|||
Configure<AbpDbContextOptions>(options => |
|||
{ |
|||
options.UseSqlServer(); |
|||
}); |
|||
} |
|||
} |
|||
} |
|||
@ -0,0 +1,3 @@ |
|||
{ |
|||
"ConnectionString": "Server=localhost;Database=VoloDocs;Trusted_Connection=True;MultipleActiveResultSets=true" |
|||
} |
|||
|
After Width: | Height: | Size: 3.1 KiB |
@ -0,0 +1,29 @@ |
|||
using Volo.Abp.AspNetCore.Mvc.UI.Theme.Shared.Components; |
|||
using Volo.Abp.Configuration; |
|||
using Volo.Abp.DependencyInjection; |
|||
|
|||
namespace Volo.Docs.Branding |
|||
{ |
|||
[Dependency(ReplaceServices = true)] |
|||
public class VoloDocsBrandingProvider : DefaultBrandingProvider |
|||
{ |
|||
public VoloDocsBrandingProvider(IConfigurationAccessor configurationAccessor) |
|||
{ |
|||
var configuration = configurationAccessor.Configuration; |
|||
|
|||
if (configuration["Title"] != null) |
|||
{ |
|||
AppName = configuration["Title"]; |
|||
} |
|||
|
|||
if (configuration["LogoUrl"] != null) |
|||
{ |
|||
LogoUrl = configuration["LogoUrl"]; |
|||
} |
|||
} |
|||
|
|||
public override string AppName { get; } |
|||
|
|||
public override string LogoUrl { get; } |
|||
} |
|||
} |
|||
@ -1,6 +1,6 @@ |
|||
using Volo.Abp.AspNetCore.Mvc; |
|||
|
|||
namespace Volo.DocsTestApp.Controllers |
|||
namespace Volo.Docs.Controllers |
|||
{ |
|||
public class HomeController : AbpController |
|||
{ |
|||
@ -0,0 +1,9 @@ |
|||
{ |
|||
"culture": "en", |
|||
"texts": { |
|||
"WelcomeVoloDocs": "Welcome to the VoloDocs!", |
|||
"NoProjectWarning": "There`s no defined project yet!", |
|||
"CreateYourFirstProject": "Click here to start your first project", |
|||
"NoProject": "No project!" |
|||
} |
|||
} |
|||
@ -0,0 +1,9 @@ |
|||
{ |
|||
"culture": "tr", |
|||
"texts": { |
|||
"WelcomeVoloDocs": "VoloDocs Hoşgeldiniz!", |
|||
"NoProjectWarning": "Henüz bir proje yok!", |
|||
"CreateYourFirstProject": "İlk projenizi oluşturmak için tıklayın", |
|||
"NoProject": "Proje yok!" |
|||
} |
|||
} |
|||
@ -0,0 +1,11 @@ |
|||
@page |
|||
@model VoloDocs.Web.Pages.ErrorModel |
|||
@{ |
|||
<div class="text-center"> |
|||
<pre> |
|||
@Model.ErrorMessage |
|||
</pre> |
|||
|
|||
<a href="/" class="btn btn-outline-primary">Home Page</a> |
|||
</div> |
|||
} |
|||
@ -0,0 +1,55 @@ |
|||
@page |
|||
|
|||
@using Microsoft.AspNetCore.Mvc.Localization |
|||
@using Volo.Docs |
|||
@using Volo.Docs.Localization |
|||
@using Volo.Docs.Pages.Documents |
|||
|
|||
@model VoloDocs.Web.Pages.IndexModel |
|||
@inject IHtmlLocalizer<DocsResource> L |
|||
|
|||
@section styles { |
|||
<abp-style-bundle name="@typeof(IndexModel).FullName"> |
|||
<abp-style src="/Pages/Documents/Shared/Styles/vs.css" /> |
|||
<abp-style src="/assets/fa/css/font-awesome.min.css" /> |
|||
</abp-style-bundle> |
|||
} |
|||
|
|||
<div class="p-5"> |
|||
|
|||
<h1 class="text-center mb-5"> |
|||
@L["WelcomeVoloDocs"] |
|||
</h1> |
|||
|
|||
@if (!Model.Projects.Any()) |
|||
{ |
|||
<div class="d-flex justify-content-center"> |
|||
<div class="alert alert-secondary col-md-6 text-center" role="alert"> |
|||
<p>@L["NoProjectWarning"]</p> |
|||
<hr /> |
|||
<a href="@Model.CreateProjectLink">@L["CreateYourFirstProject"] <i class="fa fa-arrow-circle-right"></i></a> |
|||
</div> |
|||
</div> |
|||
} |
|||
else if (Model.Projects.Count > 1) |
|||
{ |
|||
<h2>@L["Projects"]</h2> |
|||
<p> |
|||
<ul style="list-style-type: upper-roman;"> |
|||
@foreach (var project in Model.Projects) |
|||
{ |
|||
<li> |
|||
<h3> |
|||
<a asp-page="./Project/Index" |
|||
asp-route-projectName="@project.ShortName" |
|||
asp-route-version="@DocsAppConsts.Latest"> |
|||
@project.Name |
|||
</a> |
|||
</h3> |
|||
</li> |
|||
} |
|||
</ul> |
|||
</p> |
|||
} |
|||
|
|||
</div> |
|||
@ -0,0 +1,46 @@ |
|||
using System.Collections.Generic; |
|||
using System.Threading.Tasks; |
|||
using Microsoft.AspNetCore.Mvc; |
|||
using Microsoft.AspNetCore.Mvc.RazorPages; |
|||
using Volo.Abp.Users; |
|||
using Volo.Docs; |
|||
using Volo.Docs.Projects; |
|||
|
|||
namespace VoloDocs.Web.Pages |
|||
{ |
|||
public class IndexModel : PageModel |
|||
{ |
|||
public IReadOnlyList<ProjectDto> Projects { get; set; } |
|||
public string CreateProjectLink { get; set; } |
|||
|
|||
private readonly IProjectAppService _projectAppService; |
|||
private readonly ICurrentUser _currentUser; |
|||
|
|||
public IndexModel(IProjectAppService projectAppService, ICurrentUser currentUser) |
|||
{ |
|||
_projectAppService = projectAppService; |
|||
_currentUser = currentUser; |
|||
} |
|||
|
|||
public async Task<IActionResult> OnGet() |
|||
{ |
|||
CreateProjectLink = _currentUser.Id.HasValue |
|||
? "/Docs/Admin/Projects" |
|||
: "/Account/Login?returnUrl=/Docs/Admin/Projects"; |
|||
|
|||
Projects = (await _projectAppService.GetListAsync()).Items; |
|||
|
|||
if (Projects.Count == 1) |
|||
{ |
|||
return RedirectToPage("./Documents/Project/Index", new |
|||
{ |
|||
projectName = Projects[0].ShortName, |
|||
version = DocsAppConsts.Latest, |
|||
documentName = Projects[0].DefaultDocumentName |
|||
}); |
|||
} |
|||
|
|||
return Page(); |
|||
} |
|||
} |
|||
} |
|||
@ -0,0 +1,32 @@ |
|||
using System; |
|||
using System.Threading.Tasks; |
|||
using Microsoft.AspNetCore.Http; |
|||
using Microsoft.Extensions.Logging; |
|||
using Volo.Abp.AspNetCore.Uow; |
|||
|
|||
namespace VoloDocs.Web.Utils |
|||
{ |
|||
public class GlobalExceptionHandlerMiddleware |
|||
{ |
|||
private readonly RequestDelegate _next; |
|||
private readonly ILogger<AbpUnitOfWorkMiddleware> _logger; |
|||
|
|||
public GlobalExceptionHandlerMiddleware(RequestDelegate next, ILogger<AbpUnitOfWorkMiddleware> logger) |
|||
{ |
|||
_logger = logger; |
|||
_next = next; |
|||
} |
|||
|
|||
public async Task Invoke(HttpContext httpContext) |
|||
{ |
|||
try |
|||
{ |
|||
await _next(httpContext); |
|||
} |
|||
catch (Exception ex) |
|||
{ |
|||
_logger.LogError("Handled a global exception: " + ex.Message, ex); |
|||
} |
|||
} |
|||
} |
|||
} |
|||
@ -0,0 +1,5 @@ |
|||
{ |
|||
"ConnectionString": "Server=localhost;Database=VoloDocs;Trusted_Connection=True;MultipleActiveResultSets=true", |
|||
"Title": "Volo Documents", |
|||
"LogoUrl": "/Assets/Images/Logo.png" |
|||
} |
|||
@ -0,0 +1,11 @@ |
|||
@echo off |
|||
|
|||
dotnet clean |
|||
dotnet restore |
|||
dotnet build |
|||
|
|||
DEL /F/Q/S "C:\Publishes\VoloDocs" > NUL && RMDIR /Q/S "C:\Publishes\VoloDocs" |
|||
|
|||
dotnet publish -c Release -o "C:\Publishes\VoloDocs\Web" |
|||
|
|||
cd..\VoloDocs.Migrator && dotnet publish -c Release -o "C:\Publishes\VoloDocs\Migrator" |
|||
@ -0,0 +1 @@ |
|||
@dotnet VoloDocs.Web.dll |
|||
|
Before Width: | Height: | Size: 434 KiB After Width: | Height: | Size: 434 KiB |
Some files were not shown because too many files changed in this diff
Loading…
Reference in new issue