Improve docs with styling and more content (#102)

* Add styling and more content

* Finish beautifying docs

docs/make.jl

@@ -13,12 +13,12 @@ makedocs(;
  deploy_url = "Caltech-OCTO.github.io/Subzero.jl",
  ),
  pages=[
- "Home" => "index.md",
+ "Introduction" => "introduction.md",
+ "API Reference" => "api.md",
  ],
  warnonly = true,
 )
 
 deploydocs(;
  repo="https://github.com/Caltech-OCTO/Subzero.jl",
- push_preview=true,
 )

docs/src/api.md

@@ -0,0 +1,18 @@
+```@meta
+CurrentModule = Subzero
+```
+
+# Full Subzero API documentation
+
+!!! warning
+ This page is still very much WIP!
+
+Documentation for [Subzero](https://github.com/Caltech-OCTO/Subzero.jl)'s full API (only for reference!).
+
+```@index
+```
+
+## All methods
+```@autodocs
+Modules = [Subzero]
+```

docs/src/index.md

@@ -1,7 +1,39 @@
-# Subzero.jl
+```@raw html
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
 
-Documentation for `Subzero.jl`.
+hero:
+ name: "Subzero.jl"
+ text: ""
+ tagline: Fast and Flexible Sea Ice Dynamics
+ actions:
+ - theme: brand
+ text: Introduction
+ link: /introduction
+ - theme: alt
+ text: API Reference
+ link: /api
+ - theme: alt
+ text: View on Github
+ link: https://github.com/Caltech-OCTO/Subzero.jl
 
-```@autodocs
-Modules=[Subzero]
-```
+features:
+ - icon: <img width="64" height="64" src="https://rawcdn.githack.com/JuliaLang/julia-logo-graphics/f3a09eb033b653970c5b8412e7755e3c7d78db9e/images/juliadots.iconset/icon_512x512.png" alt="Julia code"/>
+ title: Pure Julia code
+ details: Fast, understandable, extensible functions
+ link: "https://julialang.org/"
+ - icon: <img width="64" height="64" src="https://fredrikekre.github.io/Literate.jl/v2/assets/logo.png" />
+ title: Literate programming
+ details: Documented source code with examples!
+ link: "https://github.com/fredrikekre/Literate.jl"
+---
+
+<p style="margin-bottom:2cm"></p>
+
+<div class="vp-doc" style="width:80%; margin:auto">
+
+# What is Subzero.jl?
+
+</div>
+```

docs/src/introduction.md

@@ -0,0 +1,3 @@
+# Introduction
+
+## Main concepts