The .NET Foundation's website
Перейти к файлу
Claire Novotny fe317de0be
Merge pull request #357 from josesimoes/patch-1
Fix nanoFramework logo
2020-09-26 08:51:40 -04:00
.github Fix build flow 2020-07-10 08:08:20 -04:00
Properties Moves everything to the root and fixes the edit on GitHub link 2020-05-06 09:24:00 -04:00
Utils Run dotnet format 2020-08-09 19:14:51 +02:00
functions Bump node-fetch from 2.6.0 to 2.6.1 in /functions 2020-09-13 00:41:40 +00:00
input Fix nanoFramework logo 2020-09-25 22:33:57 +01:00
.editorconfig move to root 2020-05-01 10:00:55 -04:00
.gitattributes add editorconfig 2020-04-22 16:39:13 -04:00
.gitignore Ignore .idea from JetBrains Product Line 2020-08-21 10:49:37 -04:00
App.config Mark current board members 2020-08-04 10:52:26 -04:00
AppSettings.cs Run dotnet format 2020-08-09 19:14:51 +02:00
CODE_OF_CONDUCT.md Add a code of conduct 2020-07-28 14:57:22 +02:00
Generator.csproj Changes required for new version of Statiq 2020-09-24 08:55:31 -04:00
Generator.sln Moves everything to the root and fixes the edit on GitHub link 2020-05-06 09:24:00 -04:00
LICENSE Create LICENSE 2020-04-29 12:21:47 -04:00
Program.cs Changes required for new version of Statiq 2020-09-24 08:55:31 -04:00
README.md Update README.md 2020-05-12 11:36:20 +02:00
azure-pipelines.yml Maybe the project wildcard needs to be quoted? 2020-05-06 09:39:46 -04:00

README.md

dotnetfoundation-website

This repository contains the solution that is used to build and deploy the dotnetfoundation website.

Pull requests and issues are welcome!

Prerequisites

Build and test

The basic steps to run or build the project:

  1. Use dotnet run from the root of the repository to generate the static site.
  2. After the build, check the output folder to review the generated HTML files.

To build and preview the site, run:

dotnet run -- preview

The preceding command launches a preview web server that can be viewed from http://localhost:5080. The site automatically rebuilds and refreshes when content changes are made.

Project Structure

This website uses Statiq Web, a flexible and extensible static site generator for .NET.

  • App.Config : The configuration file for the project. Review the appSettings section of App.Config.

  • Program.cs:

    • Handles the generation of the site.
    • Starts the web server when running from Visual Studio.
    • Defines the input folder and the output of static files.
  • input : The input folder contains source files that are rendered as HTML files.

    • _partials folder contains small sections of code that are required in ther views, includes:
      • _head.cshtml: Contains the head section of the view and includes the initial stylesheet and JavaScript imports.
      • _header.cshtml: Common header used for views. Includes the main navigation.
      • _footer.cshtml: Common footer for views.
    • _layout.cshtml: Location where the page structure, include partials, nalytics code, and other imports are built.
    • index.cshtml: Main page for the site. Properties for the page can be efined at the top of the file. For example, a specific title for the page.
    • css folder contains all the stylesheet files required.
    • js folder contains the JavaScript libraries and other custom scripts.

Each file inside the input folder is processed by Statiq and will generate static output files.