Skip to content

Commit

Permalink
Update all
Browse files Browse the repository at this point in the history
  • Loading branch information
hoontee committed Nov 30, 2023
1 parent ff4e4a8 commit c86a4ac
Show file tree
Hide file tree
Showing 12 changed files with 86 additions and 52 deletions.
25 changes: 17 additions & 8 deletions docs/.vitepress/config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,14 @@ export default defineConfig({
text: 'Getting Started',
collapsed: false,
items: [
{ text: 'Usage', link: '/lync/getting-started/usage' },
{
text: 'Usage',
collapsed: false,
items: [
{ text: 'Command Line', link: '/lync/getting-started/usage/command-line' },
{ text: 'Studio Plugin', link: '/lync/getting-started/usage/studio-plugin' }
]
},
{ text: 'Create a New Project', link: '/lync/getting-started/new-project' },
{ text: 'Convert an Existing Place', link: '/lync/getting-started/convert-place' }
]
Expand All @@ -49,19 +56,21 @@ export default defineConfig({
text: 'Project File',
collapsed: false,
items: [
{ text: 'Syntax', link: '/lync/project-format/project-json/overview' },
{ text: 'Packages', link: '/lync/project-format/project-json/packages' },
{ text: 'Automated Downloads', link: '/lync/project-format/project-json/automated-downloads' },
{ text: 'Automated Jobs', link: '/lync/project-format/project-json/automated-jobs' }
{ text: 'Syntax', link: '/lync/project-format/project-file/syntax' },
{ text: 'Packages', link: '/lync/project-format/project-file/packages' },
{ text: 'Automated Downloads', link: '/lync/project-format/project-file/automated-downloads' },
{ text: 'Automated Jobs', link: '/lync/project-format/project-file/automated-jobs' }
]
},
{
text: 'Files',
collapsed: false,
items: [
{ text: 'Filetypes', link: '/lync/project-format/files/filetypes' },
{ text: 'Model Files', link: '/lync/project-format/files/model-files' },
{ text: 'Meta Files', link: '/lync/project-format/files/meta-files' }
{ text: 'Supported Files', link: '/lync/project-format/files/supported-files' },
{ text: 'Script Directives', link: '/lync/project-format/files/script-directives' },
{ text: 'Init Scripts', link: '/lync/project-format/files/init-scripts' },
{ text: 'Meta Files', link: '/lync/project-format/files/meta-files' },
{ text: 'JSON Models', link: '/lync/project-format/files/json-models' }
]
},
{ text: 'Sourcemap', link: '/lync/project-format/sourcemap' }
Expand Down
38 changes: 38 additions & 0 deletions docs/lync/getting-started/usage/command-line.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Command Line

### List of Arguments
- `LYNC HELP` - Displays the list of available arguments.
- `LYNC CONFIG` - Opens the config file.
- `LYNC SERVE project.json? REMOTE?` - Syncs the project.
- `LYNC OPEN project.json? REMOTE?` - Build, syncs, and opens the project in Roblox Studio.
- `LYNC BUILD project.json?` - Builds the project to file.
- `LYNC FETCH project.json?` - Downloads the list of sources in the project file.

`project.json?` - The project file to read from and serve.


`REMOTE?` - Connect to the project's `remoteAddress` instead of the localhost.

::: warning
`REMOTE` is unimplemented!
:::

### Live Sync

The `SERVE` and `OPEN` modes start live sync.

`OPEN` functions the same as `SERVE`, except it also builds the project and opens it in Roblox Studio.

Connect to the session through the Roblox Studio plugin.

### Build to File

The `BUILD` mode builds the project to a place (or model) file.

This mode works without having Roblox Studio installed and without an internet connection.

### Fetch Downloads

The `FETCH` mode downloads the list of sources in the project file.

See [project-format/project-file/automated-downloads](/lync/project-format/project-file/automated-downloads).
Original file line number Diff line number Diff line change
@@ -1,43 +1,4 @@
# Usage

## Command Line Arguments
- `LYNC HELP` - Displays the list of available arguments.
- `LYNC CONFIG` - Opens the config file.
- `LYNC SERVE project.json? REMOTE?` - Syncs the project.
- `LYNC OPEN project.json? REMOTE?` - Build, syncs, and opens the project in Roblox Studio.
- `LYNC BUILD project.json?` - Builds the project to file.
- `LYNC FETCH project.json?` - Downloads the list of sources in the project file.

`project.json?` - The project file to read from and serve.


`REMOTE?` - Connect to the project's `remoteAddress` instead of the localhost.

::: warning
`REMOTE` is unimplemented!
:::

### Live Sync

The `SERVE` and `OPEN` modes start live sync.

`OPEN` functions the same as `SERVE`, except it also builds the project and opens it in Roblox Studio.

Connect to the session through the Roblox Studio plugin.

### Build to File

The `BUILD` mode builds the project to a place (or model) file.

This mode works without having Roblox Studio installed and without an internet connection.

### Fetch Downloads

The `FETCH` mode downloads the list of sources in the project file.

See [lync/project-json/automated-downloads](/lync/project-format/project-json/automated-downloads).

## Studio Plugin
# Studio Plugin

### Lync Client Widget
The **Lync Client** widget is used to interface with an active live sync session.
Expand Down
8 changes: 4 additions & 4 deletions docs/lync/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,12 @@ The Roblox Studio editor is slow and has a limited feature set. Lync allows you

Unlike [the upcoming built-in Open Cloud file sync feature](https://devforum.roblox.com/t/what-we-announced-at-rdc-2023/2585405), Lync deals with more than just scripts - all in-game content can be synced: scripts, models, and properties.

See [lync/project-format/files/filetypes](/lync/project-format/files/filetypes).
See [project-format/files/supported-files](/lync/project-format/files/supported-files).

### Automation

Lync offers additional built-in tools for power users to automate aspects of the project.

- [**Packages**](/lync/project-format/project-json/packages) - Download GitHub repositories and insert their contents into the project.
- [**Automated Downloads**](/lync/project-format/project-json/automated-downloads) - Download a list of sources into the project.
- [**Automated Jobs**](/lync/project-format/project-json/automated-jobs) - Run scripts based on file system event criteria.
- [**Packages**](/lync/project-format/project-file/packages) - Download GitHub repositories and insert their contents into the project.
- [**Automated Downloads**](/lync/project-format/project-file/automated-downloads) - Download a list of sources into the project.
- [**Automated Jobs**](/lync/project-format/project-file/automated-jobs) - Run scripts based on file system event criteria.
File renamed without changes.
7 changes: 7 additions & 0 deletions docs/lync/project-format/files/script-directives.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Script Directives
Add the following directives to the top of your script to control its [RunContext](https://create.roblox.com/docs/reference/engine/enums/RunContext) or to disable it:
* `--@script` / `--@script:legacy`
* `--@script:server`
* `--@script:client`
* `--@localscript` / `--@script:localscript`
* `--@disabled`
19 changes: 19 additions & 0 deletions docs/lync/project-format/files/supported-files.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Supported Files
| Concept | File Extension | Roblox ClassName |
|-|-|-|
| Folders | any directory | Folder
| Scripts | `LUA`/`LUAU` | [LuaSourceContainer](https://create.roblox.com/docs/reference/engine/classes/LuaSourceContainer) * |
| Models | `RBXM`/`RBXMX` | Varies |
| JSON Objects | `JSON` | [ModuleScript](https://create.roblox.com/docs/reference/engine/classes/ModuleScript) |
| YAML Objects | `YAML` | [ModuleScript](https://create.roblox.com/docs/reference/engine/classes/ModuleScript) |
| TOML Objects | `TOML` | [ModuleScript](https://create.roblox.com/docs/reference/engine/classes/ModuleScript) |
| Excel Sheets | `XLSX`/`XLS` | [ModuleScript](https://create.roblox.com/docs/reference/engine/classes/ModuleScript) |
| Text Document | `TXT` | [StringValue](https://create.roblox.com/docs/reference/engine/classes/StringValue) |
| Localization Table | `CSV` | [LocalizationTable](https://create.roblox.com/docs/reference/engine/classes/LocalizationTable) |
| Child Projects | `*.Project.JSON` | Varies |
| JSON Models | `*.Model.JSON` | Varies |
| Init Scripts (Anonymous) | `Init.LUA` / `LUAU` | [LuaSourceContainer](https://create.roblox.com/docs/reference/engine/classes/LuaSourceContainer) * |
| Init Scripts (Named) | `*.Init.LUA` / `LUAU` | [LuaSourceContainer](https://create.roblox.com/docs/reference/engine/classes/LuaSourceContainer) * |
| Meta Files | `*.Meta.JSON` / `YAML` / `TOML` | N/A |

\* Can be [ModuleScript](https://create.roblox.com/docs/reference/engine/classes/ModuleScript), [Script](https://create.roblox.com/docs/reference/engine/classes/Script), or [LocalScript](https://create.roblox.com/docs/reference/engine/classes/ModuleScript) depending on the script run context directive

0 comments on commit c86a4ac

Please sign in to comment.