15 | @Body
16 |
17 |
6 |
9 |
10 |
20 |
21 | @code {
22 | protected override void OnInitialized()
23 | {
24 | LoadingService.StateChangedCallback = StateHasChanged;
25 | base.OnInitialized();
26 | }
27 | }
--------------------------------------------------------------------------------
/PlanetaryDocs/Pages/Add.razor:
--------------------------------------------------------------------------------
1 | @page "/Add"
2 |
3 | @inherits AddBase
4 |
5 |
11 |
14 |
18 |
19 |
6 | @if (Saving)
7 | {
8 |
--------------------------------------------------------------------------------
/.github/workflows/tests.yml:
--------------------------------------------------------------------------------
1 | name: .NET 6 Tests
2 |
3 | on:
4 | push:
5 | branches: [ main ]
6 | pull_request:
7 | branches: [ main ]
8 |
9 | jobs:
10 | test:
11 |
12 | runs-on: ubuntu-latest
13 | if: "!contains(github.event.head_commit.message, '#skip_ci')"
14 |
15 | steps:
16 | - uses: actions/checkout@v2
17 | - name: Fetch
18 | run: git fetch --unshallow
19 | - name: Setup .NET Core
20 | uses: actions/setup-dotnet@v1
21 | with:
22 | dotnet-version: 6.0.x
23 | include-prerelease: true
24 | source-url: https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet6/nuget/v3/index.json
25 | env:
26 | NUGET_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}
27 | - name: Run all tests
28 | run: dotnet test PlanetaryDocs.sln --logger trx
29 |
--------------------------------------------------------------------------------
/PlanetaryDocs/Services/KeyNames.cs:
--------------------------------------------------------------------------------
1 | // Copyright (c) Jeremy Likness. All rights reserved.
2 | // Licensed under the MIT License. See LICENSE in the repository root for license information.
3 |
4 | namespace PlanetaryDocs.Services
5 | {
6 | ///
21 |
29 | }
30 |
22 |
28 |
4 |
5 | @LabelText
6 |
7 | @if (Selected)
8 | {
9 |
14 | @SelectedValue
15 |
16 | }
17 | else
18 | {
19 |
24 | }
25 |
26 | @if (!Selected && Values != null)
27 | {
28 | foreach (var result in Values)
29 | {
30 |
34 |
--------------------------------------------------------------------------------
/PlanetaryDocs/Shared/EditBar.razor:
--------------------------------------------------------------------------------
1 | @inherits EditBarBase
2 |
3 | @result
31 | } 32 | } 33 |
4 |
25 |
5 |
11 | (@ChangeCount changes detected)
12 |
17 |
18 |
23 |
24 |
26 |
--------------------------------------------------------------------------------
/PlanetaryDocs/Services/HistoryService.cs:
--------------------------------------------------------------------------------
1 | // Copyright (c) Jeremy Likness. All rights reserved.
2 | // Licensed under the MIT License. See LICENSE in the repository root for license information.
3 |
4 | using System;
5 | using System.Threading.Tasks;
6 | using Microsoft.JSInterop;
7 |
8 | namespace PlanetaryDocs.Services
9 | {
10 | ///
27 |
28 |
29 |
4 |
--------------------------------------------------------------------------------
/PlanetaryDocs/Shared/TagPicker.razor:
--------------------------------------------------------------------------------
1 | @inherits TagPickerBase
2 |
3 | @if (Tags != null && Tags.Count > 0)
4 | {
5 | foreach (var tag in Tags)
6 | {
7 |
8 | "@tag" [x]
13 |
14 |
15 | }
16 | }
17 | @if (PickNew)
18 | {
19 |
5 |
28 | @if (Validation != null && Validation.IsValid == false)
29 | {
30 |
6 | @if (UseTextArea)
7 | {
8 |
16 | }
17 | else
18 | {
19 |
25 | }
26 |
27 |
31 |
35 | }
36 |
32 |
34 | @Validation.Message
33 |
23 |
24 | An error has occurred. This application may no longer respond until reloaded.
25 |
26 |
27 | An unhandled exception has occurred. See browser dev tools for details.
28 |
29 | Reload
30 | 🗙
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
--------------------------------------------------------------------------------
/PlanetaryDocs/Shared/NavMenu.razor.css:
--------------------------------------------------------------------------------
1 | .navbar-toggler {
2 | background-color: rgba(255, 255, 255, 0.1);
3 | }
4 |
5 | .top-row {
6 | height: 3.5rem;
7 | background-color: rgba(0,0,0,0.4);
8 | }
9 |
10 | .navbar-brand {
11 | font-size: 1.1rem;
12 | }
13 |
14 | .oi {
15 | width: 2rem;
16 | font-size: 1.1rem;
17 | vertical-align: text-top;
18 | top: -2px;
19 | }
20 |
21 | .nav-item {
22 | font-size: 0.9rem;
23 | padding-bottom: 0.5rem;
24 | }
25 |
26 | .nav-item:first-of-type {
27 | padding-top: 1rem;
28 | }
29 |
30 | .nav-item:last-of-type {
31 | padding-bottom: 1rem;
32 | }
33 |
34 | .nav-item ::deep a {
35 | color: #d7d7d7;
36 | border-radius: 4px;
37 | height: 3rem;
38 | display: flex;
39 | align-items: center;
40 | line-height: 3rem;
41 | }
42 |
43 | .nav-item ::deep a.active {
44 | background-color: rgba(255,255,255,0.25);
45 | color: white;
46 | }
47 |
48 | .nav-item ::deep a:hover {
49 | background-color: rgba(255,255,255,0.1);
50 | color: white;
51 | }
52 |
53 | @media (min-width: 400px) {
54 | .navbar-toggler {
55 | display: none;
56 | }
57 |
58 | .collapse {
59 | /* Never collapse the sidebar for wide screens */
60 | display: block;
61 | }
62 | }
63 |
64 | .version {
65 | font-size: 0.7em;
66 | color: white;
67 | text-align: center;
68 | }
--------------------------------------------------------------------------------
/PlanetaryDocs/Shared/DocHistory.razor:
--------------------------------------------------------------------------------
1 | @inherits DocHistoryBase
2 |
3 | @if (History != null)
4 | {
5 |
6 | @if (History.Count == 0)
7 | {
8 |
36 | }
37 |
--------------------------------------------------------------------------------
/PlanetaryDocs/wwwroot/css/site.css:
--------------------------------------------------------------------------------
1 | @import url('open-iconic/font/css/open-iconic-bootstrap.min.css');
2 |
3 | html, body {
4 | font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
5 | }
6 |
7 | body::before {
8 | content: "";
9 | background-image: url(../images/m42hubble.jpg);
10 | background-size: cover;
11 | position: absolute;
12 | top: 0px;
13 | right: 0px;
14 | bottom: 0px;
15 | left: 0px;
16 | opacity: 0.5;
17 | }
18 |
19 |
20 | a, .btn-link {
21 | color: #0366d6;
22 | }
23 |
24 | .btn-primary {
25 | color: #fff;
26 | background-color: #1b6ec2;
27 | border-color: #1861ac;
28 | }
29 |
30 | .content {
31 | padding-top: 1.1rem;
32 | height: 100%;
33 | }
34 |
35 | .valid.modified:not([type=checkbox]) {
36 | outline: 1px solid #26b050;
37 | }
38 |
39 | .invalid {
40 | outline: 1px solid red;
41 | }
42 |
43 | .validation-message {
44 | color: red;
45 | }
46 |
47 | #blazor-error-ui {
48 | background: lightyellow;
49 | bottom: 0;
50 | box-shadow: 0 -1px 2px rgba(0, 0, 0, 0.2);
51 | display: none;
52 | left: 0;
53 | padding: 0.6rem 1.25rem 0.7rem 1.25rem;
54 | position: fixed;
55 | width: 100%;
56 | z-index: 1000;
57 | }
58 |
59 | #blazor-error-ui .dismiss {
60 | cursor: pointer;
61 | position: absolute;
62 | right: 0.75rem;
63 | top: 0.5rem;
64 | }
65 |
66 | .row {
67 | padding: 0.2em;
68 | }
--------------------------------------------------------------------------------
/PlanetaryDocs/Shared/MainLayout.razor.css:
--------------------------------------------------------------------------------
1 | .page {
2 | position: relative;
3 | display: flex;
4 | flex-direction: column;
5 | }
6 |
7 | .main {
8 | flex: 1;
9 | }
10 |
11 | .sidebar {
12 | background-image: linear-gradient(180deg, rgb(5, 39, 103) 0%, #3a0647 70%);
13 | }
14 |
15 | .top-row {
16 | background-color: #f7f7f7;
17 | border-bottom: 1px solid #d6d5d5;
18 | justify-content: flex-end;
19 | height: 3.5rem;
20 | display: flex;
21 | align-items: center;
22 | }
23 |
24 | .top-row ::deep a, .top-row .btn-link {
25 | white-space: nowrap;
26 | margin-left: 1.5rem;
27 | }
28 |
29 | .top-row a:first-child {
30 | overflow: hidden;
31 | text-overflow: ellipsis;
32 | }
33 |
34 | @media (max-width: 640.98px) {
35 | .top-row:not(.auth) {
36 | display: none;
37 | }
38 |
39 | .top-row.auth {
40 | justify-content: space-between;
41 | }
42 |
43 | .top-row a, .top-row .btn-link {
44 | margin-left: 0;
45 | }
46 | }
47 |
48 | @media (min-width: 641px) {
49 | .page {
50 | flex-direction: row;
51 | }
52 |
53 | .sidebar {
54 | width: 250px;
55 | height: 100vh;
56 | position: sticky;
57 | top: 0;
58 | }
59 |
60 | .top-row {
61 | position: sticky;
62 | top: 0;
63 | z-index: 1;
64 | }
65 |
66 | .main > div {
67 | padding-left: 2rem !important;
68 | padding-right: 1.5rem !important;
69 | }
70 | }
71 |
--------------------------------------------------------------------------------
/PlanetaryDocs/Pages/Edit.razor:
--------------------------------------------------------------------------------
1 | @page "/Edit/{Uid}"
2 |
3 | @inherits EditBase
4 |
5 |
9 |
13 | }
14 | @if (History.Count > 0)
15 | {
16 |
10 |
12 | No audits found for the document.
11 |
17 |
21 |
18 |
20 | @History.Count audit@(History.Count == 1 ? string.Empty : "s") found for the document.
19 |
22 |
26 | @foreach (var item in History)
27 | {
28 | Date Modified
23 | Alias
24 | Title
25 |
29 |
33 | }
34 | }
35 | @item.Timestamp
30 | @item.Alias
31 | @item.Title
32 |
6 | @if (NotFound)
7 | {
8 |
--------------------------------------------------------------------------------
/PlanetaryDocs/Shared/NavMenu.razor:
--------------------------------------------------------------------------------
1 | @inherits NavMenuBase
2 |
3 |
14 |
15 |
9 |
15 | }
16 | else if (Saving)
17 | {
18 |
10 |
14 |
11 | A document with the id '@Uid' was not found.
12 |
13 |
33 |
39 | }
40 |
34 |
38 |
35 | The document was updated since it was last loaded. You can save again to overwrite changes or reset to reload the document and view the changes.
36 |
37 |
41 |
48 | }
49 |
42 |
47 |
16 |
40 |
41 |
42 |
43 | version: @Version
44 |
--------------------------------------------------------------------------------
/PlanetaryDocs/Pages/Error.cshtml:
--------------------------------------------------------------------------------
1 | @page
2 |
3 | @model PlanetaryDocs.Pages.ErrorModel
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
18 |
41 |
42 |
43 |
44 |
--------------------------------------------------------------------------------
/Directory.Build.props:
--------------------------------------------------------------------------------
1 |
19 |
40 | Error.
20 |An error occurred while processing your request.
21 | 22 | @if (Model.ShowRequestId) 23 | { 24 |
25 | Request ID: @Model.RequestId
26 |
Development Mode
30 |31 | Swapping to the Development environment displays detailed information about the error that occurred. 32 |
33 |34 | The Development environment shouldn't be enabled for deployed applications. 35 | It can result in displaying sensitive information from exceptions to end users. 36 | For local debugging, enable the Development environment by setting the ASPNETCORE_ENVIRONMENT environment variable to Development 37 | and restarting the app. 38 |
39 |Hi
"; 14 | 15 | private readonly DateTime PublishDate = 16 | DateTime.UtcNow.AddDays(-2); 17 | 18 | private Document NewDoc() 19 | { 20 | var doc = new Document 21 | { 22 | AuthorAlias = Author, 23 | Description = $"Document by {Author}", 24 | Html = Html, 25 | Markdown = Markdown, 26 | PublishDate = PublishDate, 27 | Title = "Title of document" 28 | }; 29 | 30 | doc.Tags.Add("one"); 31 | doc.Tags.Add("two"); 32 | 33 | return doc; 34 | } 35 | 36 | [Fact] 37 | public void New_Instance_With_Doc_Generates_New_Guid() 38 | { 39 | // arrange 40 | var doc = NewDoc(); 41 | 42 | // act 43 | var docAudit = new DocumentAudit(doc); 44 | 45 | // assert 46 | Assert.NotEqual(default, docAudit.Id); 47 | } 48 | 49 | [Fact] 50 | public void Uid_Initializes_To_Uid_Of_Document() 51 | { 52 | // arrange 53 | var doc = NewDoc(); 54 | 55 | // act 56 | var docAudit = new DocumentAudit(doc); 57 | 58 | // assert 59 | Assert.Equal(doc.Uid, docAudit.Uid); 60 | } 61 | 62 | [Fact] 63 | public void Timestamp_Defaults_To_UtcNow() 64 | { 65 | // arrange 66 | var doc = NewDoc(); 67 | 68 | // act 69 | var docAudit = new DocumentAudit(doc); 70 | var now = DateTimeOffset.UtcNow; 71 | var diff = now - docAudit.Timestamp; 72 | var tolerance = TimeSpan.FromMilliseconds(50); 73 | 74 | // assert 75 | Assert.True(diff < tolerance); 76 | } 77 | 78 | [Fact] 79 | public void Document_Is_Json_Serialized_Snapshot() 80 | { 81 | // arrange 82 | var doc = NewDoc(); 83 | 84 | // act 85 | var docAudit = new DocumentAudit(doc); 86 | var serialized = JsonSerializer.Serialize(doc); 87 | 88 | // assert 89 | Assert.Equal(serialized, docAudit.Document); 90 | } 91 | 92 | public static IEnumerable
30 | ```
31 |
32 | #### Using Open Iconic's SVG Sprite
33 |
34 | Open Iconic also comes in a SVG sprite which allows you to display all the icons in the set with a single request. It's like an icon font, without being a hack.
35 |
36 | Adding an icon from an SVG sprite is a little different than what you're used to, but it's still a piece of cake. *Tip: To make your icons easily style able, we suggest adding a general class to the* `