Skip to content

Commit

Permalink
Updated a lot docs. [skip CI]
Browse files Browse the repository at this point in the history
  • Loading branch information
pigpigyyy committed Feb 8, 2025
1 parent c10cd65 commit 443e6b1
Show file tree
Hide file tree
Showing 92 changed files with 926 additions and 122 deletions.
10 changes: 5 additions & 5 deletions Docs/blog/2024-3-25-indie-game-made-so-hard.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Developing my own games has been a dream since childhood, particularly fueled by
## The Fun and Challenges of Game Scripting Languages

<p align="center">
<img src='/img/3.png' alt='Multilingual Playground!' height='400px'/>
<img src='/img/art/casual/3.png' alt='Multilingual Playground!' height='400px'/>
Multilingual Playground!
</p>

Expand All @@ -23,7 +23,7 @@ Programming in various languages is exhilarating, as each language offers unique
## Innovating with Game Engines

<p align="center">
<img src='/img/2.png' alt='Game creation at your fingertips!' height='400px'/>
<img src='/img/art/casual/2.png' alt='Game creation at your fingertips!' height='400px'/>
Game creation at your fingertips!
</p>

Expand All @@ -34,21 +34,21 @@ Dora SSR features a built-in Web IDE server within the game engine runtime, enab
## Pursuing the Dream of a Free and Open Gaming Handheld

<p align="center">
<img src='/img/1.png' alt='Open source everything?' height='400px'/>
<img src='/img/art/casual/1.png' alt='Open source everything?' height='400px'/>
Open source everything? Want it for both software and hardware!
</p>

Despite the progress, the pursuit of an unrestricted and open gaming development experience is far from over. As a veteran handheld gaming enthusiast dissatisfied with many commercial open-source handhelds, I envisioned a device not just for playing games but also for freely developing, running, and even distributing homemade games. Many manufacturers restrict programmability for profit, so with like-minded hardware enthusiasts, we developed the fully open "Auspice Gear", offering modular customization of its core components and design.

<p align="center">
<img src='/img/auspice-gear.png' alt='Auspice Gear + Dora SSR'/>
<img src='/img/article/auspice-gear.png' alt='Auspice Gear + Dora SSR'/>
Auspice Gear + Dora SSR
</p>

## Returning to the Essence of Game Creation

<p align="center">
<img src='/img/lsd-banner.jpg' alt='An open-source indie game project'/>
<img src='/img/article/lsd-banner.jpg' alt='An open-source indie game project'/>
An open-source indie game project made by the community called 'Luv Sense Digital'
</p>

Expand Down
8 changes: 4 additions & 4 deletions Docs/blog/2024-4-15-rusty-game-dev.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Rust offers unparalleled memory safety guarantees and operates without the need
Before diving into development, we need to install the Dora SSR game engine. This engine supports multiple platforms including Windows, Linux, macOS, iOS, and Android. For specific installation steps and requirements, please refer to the official Quick Start Guide: [Dora SSR Quick Start](https://dora-ssr.net/docs/tutorial/quick-start).

<p align="center">
<img src='/img/rusty-0.jpg' alt='Dora SSR v1.3.17 running on macOS'/>
<img src='/img/article/rusty-0.jpg' alt='Dora SSR v1.3.17 running on macOS'/>
Dora SSR v1.3.17 running on macOS
</p>

Expand All @@ -39,7 +39,7 @@ Before diving into development, we need to install the Dora SSR game engine. Thi
Once the Dora SSR engine is running, open the Dora SSR Web IDE in your browser, right-click on the left-side game resource tree, and choose 'New' to create a new folder named 'Hello'.

<p align="center">
<img src='/img/rusty-1.jpg' alt="Accessing Dora SSR's Web IDE and creating a new folder in the browser"/>
<img src='/img/article/rusty-1.jpg' alt="Accessing Dora SSR's Web IDE and creating a new folder in the browser"/>
Accessing Dora SSR's Web IDE and creating a new folder in the browser
</p>

Expand Down Expand Up @@ -90,7 +90,7 @@ cargo build --release --target wasm32-wasip1
In the Dora SSR Web IDE, right-click the newly created 'Hello' folder, select 'Upload', and upload the compiled WASM file `init.wasm`.

<p align="center">
<img src='/img/rusty-2.jpg' alt="Uploading files through the Web IDE"/>
<img src='/img/article/rusty-2.jpg' alt="Uploading files through the Web IDE"/>
Uploading files through the Web IDE
</p>

Expand All @@ -101,7 +101,7 @@ python3 upload.py "192.168.3.1" "Hello"
```

<p align="center">
<img src='/img/rusty-3.jpg' alt="Using a script for one-click compile, upload, and run"/>
<img src='/img/article/rusty-3.jpg' alt="Using a script for one-click compile, upload, and run"/>
Using a script for one-click compile, upload, and run
</p>

Expand Down
4 changes: 2 additions & 2 deletions Docs/blog/2024-4-17-a-moon-script-tale.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ tags: [YueScript, Lua]
# The Tale of Rewriting the Moonscript Compiler

<p align="center">
<img src='/img/tokyo-moon.jpg' alt="tokyo moon" height="300px"/>
<img src='/img/article/tokyo-moon.jpg' alt="tokyo moon" height="300px"/>
</p>

## Moonscript: A Niche Language with a Twist
Expand All @@ -16,7 +16,7 @@ Moonscript is a fascinating programming language that compiles into Lua and runs
<!-- truncate -->

<p align="center">
<img src='/img/moonscript.png' alt="emotions embedded" height="200px"/>
<img src='/img/lang/moonscript.png' alt="emotions embedded" height="200px"/>
</p>

## Open Source and Free: A Challenging Sustainability
Expand Down
6 changes: 3 additions & 3 deletions Docs/blog/2024-4-25-tsx-dev-intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Developing games with TSX means you can leverage your existing frontend tech sta
Enough with the theory; let’s dive into some practical work. Let’s see how to write a game similar to "Angry Birds" using less than 100 lines of TSX code in Dora SSR. Before starting, setting up the development environment with Dora SSR is straightforward: install the package, open the browser, and let’s start coding! For installation and getting started, see: [Dora Startup!](https://dora-ssr.net/zh-Hans/docs/tutorial/quick-start)

<p align="center">
<img src={require('@site/static/img/dora-on-android.jpg').default} alt='Accidentally installed as an APK on your phone? Access it over the same local network for on-device development and debugging'/>
<img src={require('@site/static/img/article/dora-on-android.jpg').default} alt='Accidentally installed as an APK on your phone? Access it over the same local network for on-device development and debugging'/>
Accidentally installed as an APK on your phone? Access it over the same local network for on-device development and debugging
</p>

Expand Down Expand Up @@ -224,12 +224,12 @@ Lastly, we use the `body` component to create the bird and set its collision sha
With that, we have completed the core logic of our small game. You can further refine the game logic and add features based on your own ideas. The complete demo code can be seen at this link: [Dora-SSR/Assets/Script/Test/Birdy.tsx](https://github.com/IppClub/Dora-SSR/blob/main/Assets/Script/Test/Birdy.tsx). Below are some screenshots of the game in action.

<p align="center">
<img src={require('@site/static/img/birdy1.png').default} alt='Dragging the screen to launch the "Angry Birds'/>
<img src={require('@site/static/img/article/birdy1.png').default} alt='Dragging the screen to launch the "Angry Birds'/>
Dragging the screen to launch the "Angry Birds
</p>

<p align="center">
<img src={require('@site/static/img/birdy2.png').default} alt='Skilled moves earned me all the scores in one shot'/>
<img src={require('@site/static/img/article/birdy2.png').default} alt='Skilled moves earned me all the scores in one shot'/>
Skilled moves earned me all the scores in one shot
</p>

Expand Down
12 changes: 6 additions & 6 deletions Docs/blog/2024-8-14-dora-ssr-overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ I envision a more **open and collaborative** world of **game creation**: a world
The current version (v1.5.1) of the Dora SSR engine is structured as follows:

<p align="center">
<img src={require('@site/static/img/dora-ssr-architecture.png').default} alt='Dora SSR Architecture'/>
<img src={require('@site/static/img/article/dora-ssr-architecture.png').default} alt='Dora SSR Architecture'/>
Dora SSR Architecture
</p>

Expand Down Expand Up @@ -77,7 +77,7 @@ The execution process of the Dora SSR engine can be easily understood from the p
* **Code Editor**

<p align="center">
<img src={require('@site/static/img/showcase1.jpg').default} alt='Dora SSR Code Editor'/>
<img src={require('@site/static/img/showcase/1.jpg').default} alt='Dora SSR Code Editor'/>
Dora SSR Code Editor
</p>

Expand All @@ -86,7 +86,7 @@ Dora SSR’s Web IDE offers a fully-featured code editor that supports multiple
* **Yarn Spinner Script Editor**

<p align="center">
<img src={require('@site/static/img/showcase2.jpg').default} alt='Dora SSR Story Editor'/>
<img src={require('@site/static/img/showcase/2.jpg').default} alt='Dora SSR Story Editor'/>
Dora SSR Story Editor
</p>

Expand All @@ -99,7 +99,7 @@ Yarn Spinner’s features not only improve the efficiency of game script writing
* **Visual Script Editor**

<p align="center">
<img src={require('@site/static/img/showcase3.jpg').default} alt='Dora SSR Visual Script Editor'/>
<img src={require('@site/static/img/showcase/3.jpg').default} alt='Dora SSR Visual Script Editor'/>
Dora SSR Visual Script Editor
</p>

Expand All @@ -112,7 +112,7 @@ This graphical programming approach lowers the barrier to entry for programming,
* **Spine Animation Preview**

<p align="center">
<img src={require('@site/static/img/showcase4.jpg').default} alt='Dora SSR Animation Preview'/>
<img src={require('@site/static/img/showcase/4.jpg').default} alt='Dora SSR Animation Preview'/>
Dora SSR Animation Preview
</p>

Expand All @@ -127,7 +127,7 @@ We have already been experimenting with running Dora SSR on various mobile devic
However, to ensure a good user experience, we recommend using at least a larger screen and a keyboard-equipped Android tablet or iPad to remotely access and use the Web IDE for game development on small-screen devices, providing a more comfortable game development experience. Whether at home, in a café, or outdoors, Dora SSR offers developers a game development environment that can be accessed anytime, anywhere, removing the constraints of device and location.

<p align="center">
<img src={require('@site/static/img/dev-everywhere.jpg').default} alt='Dora SSR Cross-Platform Development'/>
<img src={require('@site/static/img/showcase/dev-everywhere.jpg').default} alt='Dora SSR Cross-Platform Development'/>
Dora SSR Cross-Platform Development
</p>

Expand Down
44 changes: 44 additions & 0 deletions Docs/blog/2025-1-20-year-of-snake.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
title: A Happy New Year of the Snake for the Community!
authors: [lijin]
tags: [Chunjie]
---

As the Chunjie (Spring Festival) approaches, to welcome the lively and wise Year of the Snake, we have created several illustrations filled with the festive atmosphere of the Spring Festival for the Dora SSR open-source game engine project. These artworks convey our sincere blessings and heartfelt gratitude to all community members.

<!-- truncate -->

In this series of illustrations, a blonde little girl and a cute bear joyfully wander through the festive scenes of the Spring Festival:

### Spring Festival Travel

They carry luggage and backpacks, boarding trains to return home or embark on new journeys;

![Spring Festival Travel](@site/static/img/art/chunjie/2.png)

### Red Envelopes

Holding bright red envelopes, they share the good fortune and joy of the New Year with everyone;

![Red Envelopes](@site/static/img/art/chunjie/1.png)

### Fireworks

Fireworks light up the sky and firecrackers sound, symbolizing renewal and eager anticipation for the future. There are details representing programming languages like C++, Rust, and Lua, signifying our continued exploration of different technological fields in the new year, bringing more surprises and possibilities to Dora SSR.

![Fireworks](@site/static/img/art/chunjie/3.png)

Reflecting on the past year, we have helped each other and progressed together in the community, allowing Dora SSR to grow from an inspiration into a vibrant and evolving open-source game engine. The participation of every enthusiastic contributor, developer, and player is our driving force. Just like the joyful and lively atmosphere in the illustrations, the new year will also be a brand new journey full of opportunities and challenges.

The **snake** in the Chinese zodiac symbolizes **agility, intelligence, and insight**. Like a nimble and adaptable snake, we will continue to lead the Dora SSR project forward through continuous learning, experimentation, and iteration in the new year.

Here, we sincerely wish everyone in the new year:

1. **Smooth Coding**: May your work, studies, and development processes be more efficient and effective;
2. **Unlimited Creativity**: Whether in game creation or technical research, may you be inspired with endless ideas;
3. **Good Health**: While programming is important, don't forget to maintain a healthy lifestyle;
4. **All the Best**: Enjoy the Spring Festival with family and friends, and gather more beautiful moments.

We sincerely thank every partner for their support and contributions, and we look forward to joining hands again in the new journey of the Year of the Snake in 2025, making Dora SSR even more exciting. Let's unleash our wisdom and passion together, bringing more surprises and emotions to the community.

**Wishing you a prosperous Year of the Snake, happiness for your family, and a joyful Spring Festival!**
Loading

0 comments on commit 443e6b1

Please sign in to comment.