Skip to content

Commit

Permalink
docs: Add initial moonwave documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
Quenty committed Dec 29, 2021
1 parent 3a3d037 commit a7b74b4
Show file tree
Hide file tree
Showing 642 changed files with 10,942 additions and 3,391 deletions.
15 changes: 15 additions & 0 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,21 @@
name: Build
on: [push]
jobs:
check-moonwave-docs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: actions-rs/toolchain@v1
with:
toolchain: stable
- uses: actions-rs/cargo@v1
with:
command: install
args: moonwave

- name: Extract moonwave
run: moonwave-extractor extract src

lint:
runs-on: ubuntu-latest
steps:
Expand Down
23 changes: 23 additions & 0 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
name: Docs
on:
push:
branches:
- main
jobs:
build:
name: Build and deploy docs
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: actions/setup-node@v2
with:
node-version: "14"
- run: npm i -g moonwave@latest
- name: Publish
run: |
git remote set-url origin https://git:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git
git config --global user.email "support+actions@github.com"
git config --global user.name "github-actions-bot"
moonwave build --publish
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,5 @@
node_modules
out
roblox.toml
.env
.env
build
31 changes: 31 additions & 0 deletions docs/intro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
sidebar_position: 1
---

# What is Nevermore?

Nevermore is a ModuleScript loader for Roblox, and loads modules by name. Nevermore is designed to make code more portable. Nevermore comes with a variety of utility libraries. These libraries are used on both the client and server and are useful for a variety of things. These libraries are separated into packages that can be consumed individually using npm.

Nevermore follows both functional and OOP programming paradigms. However, many modules return classes, and may require more advance Lua knowledge to use.

# Getting Started with Nevermore

Getting started with Nevermore is not easy.

## Installing Nevermore

1. Install foreman
2. Install npm

## Install using npm
Nevermore is designed to use [npm](https://www.npmjs.com/) to manage packages. You can install a package like this.

```
npm install @quenty/maid
```

Each package is designed to be synced into Roblox using [rojo](https://rojo.space/).

:::warning
Right now you need a special version of Rojo to sync in the npm dependencies properly!
:::
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
--- Makes the character look at nearby physical buttons
-- @classmod LookAtButtonsClient
-- @author Quenty
--[=[
Makes the character look at nearby physical buttons
@class LookAtButtonsClient
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Client/GameBindersClient.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
--- Holds binders
-- @classmod GameBindersClient
-- @author Quenty
--[=[
@class GameBindersClient
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Client/GameServiceClient.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
-- @module GameServiceClient
-- @author Quenty
--[=[
@class GameServiceClient
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Client/GameTranslator.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
-- @classmod GameTranslator
-- @author Quenty
--[=[
@class GameTranslator
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
7 changes: 4 additions & 3 deletions games/integration/modules/Server/Button/LookAtButtons.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
--- Makes the character look at nearby physical buttons
-- @classmod LookAtButtons
-- @author Quenty
--[=[
Makes the character look at nearby physical buttons
@class LookAtButtons
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Server/Button/PhysicalButton.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
-- @classmod PhysicalButton
-- @author Quenty
--[=[
@class PhysicalButton
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Server/GameBindersServer.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
--- Holds binders
-- @classmod GameBindersServer
-- @author Quenty
--[=[
@class GameBindersServer
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
6 changes: 3 additions & 3 deletions games/integration/modules/Server/GameServiceServer.lua
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
-- @module GameServiceServer
-- @author Quenty
--[=[
@class GameServiceServer
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
-- @module PhysicalButtonConstants
-- @author Quenty
--[=[
@class PhysicalButtonConstants
]=]

local require = require(script.Parent.loader).load(script)

Expand Down
188 changes: 188 additions & 0 deletions moonwave.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,188 @@
title = "Nevermore"
gitRepoUrl = "https://github.com/Quenty/NevermoreEngine"

gitSourceBranch = "main"
changelog = true

organizationName = "Quenty"
projectName = "Nevermore"
url = "https://quenty.github.io"
baseUrl = "/NevermoreEngine/"
tagline = "Quenty's reusable code for Roblox"

[[navbar.items]]
href = "https://discord.gg/mhtGUS8"
label = "Discord"
position = "right"

[footer]
style = "dark"
copyright = "Copyright © 2014-2021 James Onnen."

[docusaurus]
url = "https://quenty.github.io"
baseUrl = "/NevermoreEngine/"

[home]
enabled = true
includeReadme = true

[[home.features]]
title = "Faster development"
description = "Speed up Roblox development With Nevermore. With built in IK, Ragdoll, camera systems, and more, development has never been faster."

[[home.features]]
title = "Composable"
description = "Libraries are modular! Modules are designed to compose both with Roblox and each other."

[[home.features]]
title = "Battle tested"
description = "These libraries are old, and have been used in production for millions of game sessions"

[[classOrder]]
section = "Octree"
classes = [
"Octree",
"OctreeNode",
"OctreeRegionUtils"
]

[[classOrder]]
section = "Rx"
classes = ["Rx", "Observable", "Subscription"]

[[classOrder]]
section = "DataStore"
classes = [
"DataStore",
"PlayerDataStoreManager",
"DataStorePromises",
"DataStoreWriter",
"DataStoreStage",
"DataStoreDeleteToken"
]

[[classOrder]]
section = "Promise"
classes = ["Promise", "PromiseUtils", "PendingPromiseTracker", "promiseChild"]

[[classOrder]]
section = "Signal"
classes = ["Signal", "SignalUtils"]

[[classOrder]]
section = "Binder"
classes = [
"Binder",
"BinderUtils",
"BinderGroupProvider",
"BinderGroup",
"BinderProvider",
"BoundParentTracker",
"BoundAncestorTracker",
"promiseBoundClass",
"BoundChildCollection"
]

[[classOrder]]
section = "IK"
classes = [
"ArmIKBase",
"GripPointer",
"IKAimPositionPriorites",
"IKBindersClient",
"IKBindersServer",
"IKConstants",
"IKGripBase",
"IKGripUtils",
"IKLeftGrip",
"IKResource",
"IKResourceUtils",
"IKRig",
"IKRigBase",
"IKRigClient",
"IKRightGrip",
"IKService",
"IKServiceClient",
"IKUtils",
"IKRigUtils",
"TorsoIKBase",
"TorsoIKUtils",
]

[[classOrder]]
section = "Table"
classes = ["Table", "Set"]

[[classOrder]]
section = "AttributeUtils"
classes = ["AttributeUtils", "RxAttributeUtils", "AttributeValue"]

[[classOrder]]
section = "Brio"
classes = ["Brio", "BrioUtils", "RxBrioUtils"]

[[classOrder]]
section = "Spring"
classes = ["Spring", "SpringUtils", "LinearValue"]

[[classOrder]]
section = "ValueBaseUtils"
classes = ["ValueBaseUtils", "RxValueBaseUtils"]

[[classOrder]]
section = "QFrame"
classes = ["QFrame"]

[[classOrder]]
section = "AdorneeUtils"
classes = ["AdorneeUtils"]

[[classOrder]]
section = "AccelTween"
classes = ["AccelTween"]

[[classOrder]]
section = "Camera"
classes = [
"CameraStackService",
"CameraFrame",
"CameraStateTweener",
"CameraState",
"CameraUtils",
"CameraControls",
"CameraGamepadInputUtils",
"GamepadRotateModel",
"FadeBetweenCamera",
"FadeBetweenCamera2",
"FadeBetweenCamera3",
"FadeBetweenCamera4",
"CameraEffectUtils",
"CustomCameraEffect",
"DefaultCamera",
"FadingCamera",
"HeartbeatCamera",
"ImpulseCamera",
"InverseFader",
"LagPointCamera",
"PointCamera",
"PushCamera",
"RotatedCamera",
"SmoothRotatedCamera",
"SmoothZoomedCamera",
"SummedCamera",
"TrackCamera",
"XZPlaneLockCamera",
"ZoomedCamera",
"CameraInputUtils",
"CameraTouchInputUtils",
"FieldOfViewUtils",
]

[[classOrder]]
section = "InputMode"
classes = ["InputMode", "InputModeProcessor", "InputModeSelector", "INPUT_MODES"]

[[classOrder]]
section = "Math"
classes = ["Math"]
Loading

0 comments on commit a7b74b4

Please sign in to comment.