Skip to content

Commit 1682947

Browse files
committed
Update README.md
1 parent 79abdb6 commit 1682947

File tree

1 file changed

+27
-27
lines changed

1 file changed

+27
-27
lines changed

README.md

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,44 @@
1-
# RuSTy
21

3-
[![Linux Build](https://github.com/PLC-lang/rusty/actions/workflows/linux.yml/badge.svg)](https://github.com/PLC-lang/ruSTy/actions)
4-
[![Windows Build](https://github.com/PLC-lang/rusty/actions/workflows/windows.yml/badge.svg)](https://github.com/PLC-lang/rusty/actions/workflows/windows.yml)
5-
[![Documentation](https://github.com/PLC-lang/rusty/actions/workflows/doc.yml/badge.svg)](https://plc-lang.github.io/rusty)
6-
[![codecov](https://codecov.io/gh/PLC-lang/rusty/branch/master/graph/badge.svg?token=7ZZ5XZYE9V)](https://codecov.io/gh/PLC-lang/rusty)
7-
[![Metrics](https://github.com/PLC-lang/rusty/actions/workflows/metrics.yml/badge.svg)](https://plc-lang.github.io/metrics)
2+
<div align="center">
3+
<!-- Eventually(?) we'll have a logo, which we can insert here -->
4+
<h1>RuSTy</h1>
5+
<p>A <a href="https://en.wikipedia.org/wiki/Structured_text">structured text</a> compiler written in Rust, utilizing the LLVM framework for native code compilation.</p>
6+
<p>
7+
<a href="https://github.com/PLC-lang/rusty/tree/master/examples">Examples</a> |
8+
<a href="https://plc-lang.github.io/rusty/">Documentation</a> |
9+
<a href="https://github.com/PLC-lang/rusty/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22">Contributing</a>
10+
</p>
11+
12+
</div>
13+
814

9-
[![Lines of Code](https://tokei.rs/b1/github/PLC-lang/rusty)](https://github.com/XAMPPRocky/tokei)
15+
## Why RuSTy?
1016

11-
[Structured text](https://en.wikipedia.org/wiki/Structured_text) compiler written in Rust
17+
Structured Text is a popular language in the domain of automation. A standardized specification of the language ([IEC 61131](https://en.wikipedia.org/wiki/IEC_61131)) was published in the 90s. It was updated several times in the meantime, while its initial spirit - being built for cyclic, robust and deterministic automation applications - still applies.
1218

13-
## About RuSTy
19+
Several automation platform suppliers built proprietary compilers and runtime libraries, native to the vendor's hard- and software platform.
1420

15-
RuSTy is a structured text (ST) compiler written in Rust. RuSTy utilizes the
16-
LLVM framework to compile eventually to native code.
21+
RuSTy is aiming towards a **fast**, **modern** and **open-source** industry-grade ST compiler for a wide range of platforms, sticking close to the standard.
1722

1823
## Getting started
1924

2025
The easiest way to compile this project is to use the provided `Dockerfile`. The project offers a `.devcontainer` when using [VSCode](https://code.visualstudio.com/docs/remote/containers). The Dockerfile offers a linux-image which contains everything you need to run `cargo build` / `cargo test` in the project's root directory.
2126

2227
If you want to build the project without docker, start [here](https://plc-lang.github.io/rusty/build_and_install.html).
2328

24-
### Documentation
25-
26-
The compiler's documentation can be found here: [documentation](https://plc-lang.github.io/rusty/).
2729

28-
### Contributing
2930

30-
If you want to contribute to the project you should look for some [beginner-friendly issues](https://github.com/PLC-lang/rusty/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) and reach out to project's maintainers.
31-
32-
## Why RuSTy
33-
34-
Structured Text is a popular language in the domain of automation. A standardized specification of the language ([IEC 61131](https://en.wikipedia.org/wiki/IEC_61131)) was published in the 90s. It was updated several times in the meantime, while its initial spirit - being built for cyclic, robust and deterministic automation applications - still applies.
35-
36-
Several automation platform suppliers built proprietary compilers and runtime libraries, native to the vendor's hard- and software platform.
37-
38-
RuSTy is aiming towards a _fast_, _modern_ and _open-source_ industry-grade ST compiler for a wide range of platforms, sticking close to the standard.
39-
40-
## Dependencies
31+
<!-- ## Dependencies
4132
4233
We use the [_logos_](https://crates.io/crates/logos/)
4334
crate library to perform lexical analysis before a handwritten recursive decent parser creates the AST.
44-
Generating LLVM IR is accomplished with the help of [_inkwell_](https://github.com/TheDan64/inkwell), a Rust-wrapper around the native LLVM C-API.
35+
Generating LLVM IR is accomplished with the help of [_inkwell_](https://github.com/TheDan64/inkwell), a Rust-wrapper around the native LLVM C-API. -->
36+
37+
<!-- This seems to be broken?
38+
[![Lines of Code](https://tokei.rs/b1/github/PLC-lang/rusty)](https://github.com/XAMPPRocky/tokei) -->
39+
<!-- -->
40+
<!-- [![Linux Build](https://github.com/PLC-lang/rusty/actions/workflows/linux.yml/badge.svg)](https://github.com/PLC-lang/ruSTy/actions)
41+
[![Windows Build](https://github.com/PLC-lang/rusty/actions/workflows/windows.yml/badge.svg)](https://github.com/PLC-lang/rusty/actions/workflows/windows.yml)
42+
[![Metrics](https://github.com/PLC-lang/rusty/actions/workflows/metrics.yml/badge.svg)](https://plc-lang.github.io/metrics)
43+
[![Documentation](https://github.com/PLC-lang/rusty/actions/workflows/doc.yml/badge.svg)](https://plc-lang.github.io/rusty)
44+
[![codecov](https://codecov.io/gh/PLC-lang/rusty/branch/master/graph/badge.svg?token=7ZZ5XZYE9V)](https://codecov.io/gh/PLC-lang/rusty) -->

0 commit comments

Comments
 (0)