From 79f12adb29092dafdf21054e445910c02c73f693 Mon Sep 17 00:00:00 2001 From: JaDoggx86 Date: Fri, 22 Dec 2023 00:07:54 +0000 Subject: [PATCH] update to footer,docs layout --- src/components/Footer.astro | 2 +- src/layouts/DocsLayout.astro | 44 ++++++++++--------- src/pages/docs/0001-features.mdx | 57 +++++++++---------------- src/pages/docs/0002-runtime-library.mdx | 8 ++-- src/pages/docs/0003-grammar.mdx | 6 +-- 5 files changed, 50 insertions(+), 67 deletions(-) diff --git a/src/components/Footer.astro b/src/components/Footer.astro index 51bda6b..6667631 100644 --- a/src/components/Footer.astro +++ b/src/components/Footer.astro @@ -3,7 +3,7 @@

Yaksha - The Programming Language

-

© 2023 YakshaLang

+

© 2023 Bhathiya Perera

Website designed by AbandonTech

diff --git a/src/layouts/DocsLayout.astro b/src/layouts/DocsLayout.astro index ec337f3..4359f8b 100644 --- a/src/layouts/DocsLayout.astro +++ b/src/layouts/DocsLayout.astro @@ -24,30 +24,32 @@ const headingsByDepth = headings.reduce((acc, heading) => { -
-
-
    - {headingsByDepth.map(h => -
  • - {h.children.length > 0 && -
    - {h.text} - -
    - } - {h.children.length == 0 && - {h.text} - } -
    • )} +
    + -
    - +
    +
    diff --git a/src/pages/docs/0001-features.mdx b/src/pages/docs/0001-features.mdx index 4c987a6..285494a 100644 --- a/src/pages/docs/0001-features.mdx +++ b/src/pages/docs/0001-features.mdx @@ -32,7 +32,6 @@ my_sr = "Hello World" another_sr: sr = "Hello World" ``` ---- ### String literals @@ -46,8 +45,6 @@ If you `+` two string literals that will be done at compile time. String literals are automatically converted to `sr` or `str`. ---- - ### (Semi)Managed Strings @@ -74,7 +71,6 @@ a: str = "hello world" println(a) ``` ---- ### Standard integers @@ -91,7 +87,6 @@ print("Four =") println(a) ``` ---- ### Integer types @@ -116,7 +111,6 @@ i: u32 = 4u32 # datatype ✅ | literal ✅ j: u64 = 5u64 # datatype ✅ | literal ✅ ``` ---- ### Float types @@ -133,7 +127,6 @@ b: f64 = 2.0 # datatype ✅ | literal ✅ c: float = 3.0f # datatype ✅ | literal ✅ ``` ---- ## Syntax features @@ -154,7 +147,6 @@ def main() -> int: return 0 ``` ---- ### Basic Functions @@ -169,7 +161,6 @@ def main() -> int: return 0 ``` ---- ### Exposing C functions @@ -179,7 +170,6 @@ def main() -> int: * 💀 `@nativexxx` functions cannot call each other or normal functions. ---- #### @native - native functions ```yaksha @@ -204,8 +194,6 @@ yk__sds yy__get_global_arg(int32_t nn__n) ``` ---- - ### @nativemacro - macros with arguments ```yaksha @@ -226,7 +214,6 @@ def max_int(a: int, b:int) -> int: ``` ---- ### @nativedefine - simple #define @@ -242,7 +229,6 @@ def banana(a: int, b: int, c:int) -> int: ``` ---- ### @varargs - variable argument functions @@ -263,8 +249,6 @@ def new(count: int, s: str) -> Array[str]: ``` ---- - ### Template functions @@ -291,7 +275,6 @@ def hmget(a: HashMap[K,V], key: K) -> V: pass ``` ---- ### GPU/OpenCL device functions @@ -304,7 +287,6 @@ def calculate(n: int) -> int: return 1 + 1 ``` ---- ### Defer statement @@ -339,7 +321,7 @@ Hello World All done ``` ---- + ### Del statement @@ -360,7 +342,6 @@ def main() -> int: ``` Compiles to `free` or other runtime functions. ---- ### Class statement @@ -382,7 +363,7 @@ class Teacher: address: str ``` ---- + #### Creating and freeing objects @@ -421,7 +402,7 @@ def main() -> int: return 0 ``` ---- + #### Exposing native structures @@ -446,7 +427,7 @@ class Color: ``` ---- + ### Import statement @@ -471,7 +452,7 @@ def main() -> int: Name mangling takes place for this. ---- + ### While loop @@ -488,7 +469,7 @@ def main() -> int: return 0 ``` ---- + ### Foreach loop @@ -510,7 +491,7 @@ def main() -> int: return 0 ``` ---- + ### Endless for loop @@ -529,7 +510,7 @@ def main() -> int: return 0 ``` ---- + ### C-For loop @@ -564,7 +545,7 @@ def main() -> int: * This is why `add` function does not have a return statement. ---- + ## Builtin Functions @@ -603,12 +584,12 @@ def main() -> int: Builtin functions may call different implementations based on input. ---- + ## Non primitive data types This section describes other essential types of builtin structures. ---- + ### Dynamic Arrays @@ -628,7 +609,7 @@ def main() -> int: Must ensure array elements are freed. `int` need not be deleted as they are primitive types. ---- + ### String Hash Map @@ -653,7 +634,7 @@ def main() -> int: * `len` will give the total number of elements of the String Hash Map. ---- + ### Hash Map @@ -666,7 +647,7 @@ Simple single key single value hashmaps. * key and value both need to be deleted. ---- + ## Macros & YakshaLisp @@ -682,7 +663,7 @@ It has it's own built in functions, can use `import`, read/write files and even * So you can meta-program while you meta-program. ---- + ### Philosophy? YakshaLisp provide the ability to write token-list to token-list conversion macros. One can use `my_macro!{t t t}` style expansion to achieve this. So why YakshaLisp? because it needs to process a list of tokens. @@ -690,7 +671,7 @@ Additionally, Yaksha and YakshaLisp are polar opposites of each other, therefore Think Yin-Yang! ---- + #### What are the differences? @@ -757,7 +738,7 @@ Additionally, Yaksha and YakshaLisp are polar opposites of each other, therefore ---- + ### Builtin functions, values & prelude @@ -795,7 +776,7 @@ All below listed functions are available at the moment. * `random` - random number between given range * `time` - unix time as number ---- + ### Macro environments @@ -807,7 +788,7 @@ During garbage collection, mark phase will start marking from `builtins_root` an Environment is an unordered_map with string keys. Environments and maps use same data type internally. ---- + ### How does it look like diff --git a/src/pages/docs/0002-runtime-library.mdx b/src/pages/docs/0002-runtime-library.mdx index d1b0cc4..9ab1d2a 100644 --- a/src/pages/docs/0002-runtime-library.mdx +++ b/src/pages/docs/0002-runtime-library.mdx @@ -16,7 +16,7 @@ Yaksha programming language preserves anything that starts with `yk__` or `YK__` This avoids collisions with C standard library functions or keywords. ---- + ## Standard Library Components @@ -30,7 +30,7 @@ Small core library with useful features. import libs ``` ---- + ### UI Library @@ -42,7 +42,7 @@ Use raygui with raylib. import raylib.gui ``` ---- + ### Raylib - Graphics/Game/Audio Library @@ -54,7 +54,7 @@ Use raylib to build games and such import raylib ``` ---- + ### CL Library diff --git a/src/pages/docs/0003-grammar.mdx b/src/pages/docs/0003-grammar.mdx index d8c9074..80d0f15 100644 --- a/src/pages/docs/0003-grammar.mdx +++ b/src/pages/docs/0003-grammar.mdx @@ -81,7 +81,7 @@ block: ":" (newline ba_indent standard_statement+ ba_dedent | simple_statement) * Example - `defer del my_element` ---- + ## Data Type @@ -96,7 +96,7 @@ primitive_data_type: "int" | "i8" | "i16" | "i32" | "i64" | Data type describes, primitives, custom data types and non primitives. ---- + ## Expressions @@ -121,7 +121,7 @@ primary: "True" | "False" | "None" | number | string | triple_quote_string | nam Based on [lox grammar](https://craftinginterpreters.com/appendix-i.html) and [Python operator precedence](https://www.mathcs.emory.edu/~valerie/courses/fall10/155/resources/op_precedence.html). ---- + ## Useful utils