mirror of
https://github.com/denoland/deno.git
synced 2024-11-21 15:04:11 -05:00
docs(readme): Update readme (#18677)
- updated examples - added more resources - added youtube --------- Co-authored-by: Bartek Iwańczuk <biwanczuk@gmail.com>
This commit is contained in:
parent
94744ae25a
commit
26aafd3a15
1 changed files with 42 additions and 29 deletions
71
README.md
71
README.md
|
@ -1,22 +1,29 @@
|
||||||
# Deno
|
# Deno
|
||||||
|
|
||||||
[![Build Status - Cirrus][]][Build status] [![Twitter handle][]][Twitter badge]
|
[![](https://img.shields.io/crates/v/deno.svg)](https://crates.io/crates/deno)
|
||||||
[![Discord Chat](https://img.shields.io/discord/684898665143206084?logo=discord&style=social)](https://discord.gg/deno)
|
[![Twitter badge][]][Twitter link] [![Discord badge][]][Discord link]
|
||||||
|
[![YouTube badge][]][Youtube link]
|
||||||
|
|
||||||
<img align="right" src="https://deno.land/logo.svg" height="150px" alt="the deno mascot dinosaur standing in the rain">
|
<img align="right" src="https://deno.land/logo.svg" height="150px" alt="the deno mascot dinosaur standing in the rain">
|
||||||
|
|
||||||
Deno is a _simple_, _modern_ and _secure_ runtime for **JavaScript** and
|
[Deno](https://deno.com/runtime) is a _simple_, _modern_ and _secure_ runtime
|
||||||
**TypeScript** that uses V8 and is built in Rust.
|
for **JavaScript** and **TypeScript** that uses V8 and is built in Rust.
|
||||||
|
|
||||||
### Features
|
### Features
|
||||||
|
|
||||||
- Secure by default. No file, network, or environment access, unless explicitly
|
- [Secure by default.](https://deno.land/manual/basics/permissions) No file,
|
||||||
enabled.
|
network, or environment access, unless explicitly enabled.
|
||||||
- Supports TypeScript out of the box.
|
- Provides
|
||||||
|
[web platform functionality and APIs](https://deno.land/manual/runtime/web_platform_apis),
|
||||||
|
e.g. using ES modules, web workers, and `fetch()`.
|
||||||
|
- Supports
|
||||||
|
[TypeScript out of the box](https://deno.land/manual/advanced/typescript).
|
||||||
- Ships only a single executable file.
|
- Ships only a single executable file.
|
||||||
- [Built-in utilities.](https://deno.land/manual/tools#built-in-tooling)
|
- [Built-in tooling](https://deno.land/manual/tools#built-in-tooling) including
|
||||||
- Set of reviewed standard modules that are guaranteed to work with
|
`deno test`, `deno fmt`, `deno bench`, and more.
|
||||||
[Deno](https://deno.land/std/).
|
- Includes [a set of reviewed standard modules](https://deno.land/std/)
|
||||||
|
guaranteed to work with Deno.
|
||||||
|
- [Supports npm.](https://deno.land/manual/node)
|
||||||
|
|
||||||
### Install
|
### Install
|
||||||
|
|
||||||
|
@ -62,34 +69,36 @@ and [releases](https://github.com/denoland/deno/releases) for other options.
|
||||||
|
|
||||||
### Getting Started
|
### Getting Started
|
||||||
|
|
||||||
Try running a simple program:
|
Try [running a simple program](https://examples.deno.land/hello-world):
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
deno run https://deno.land/std/examples/welcome.ts
|
deno run https://deno.land/std/examples/welcome.ts
|
||||||
```
|
```
|
||||||
|
|
||||||
Or a more complex one:
|
Or [setup a simple HTTP server](https://examples.deno.land/http-server):
|
||||||
|
|
||||||
```ts
|
```ts
|
||||||
const listener = Deno.listen({ port: 8000 });
|
import { serve } from "https://deno.land/std@0.182.0/http/server.ts";
|
||||||
console.log("http://localhost:8000/");
|
|
||||||
|
|
||||||
for await (const conn of listener) {
|
serve((_req) => new Response("Hello, World!"));
|
||||||
serve(conn);
|
|
||||||
}
|
|
||||||
|
|
||||||
async function serve(conn: Deno.Conn) {
|
|
||||||
for await (const { respondWith } of Deno.serveHttp(conn)) {
|
|
||||||
respondWith(new Response("Hello world"));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
```
|
||||||
|
|
||||||
You can find a deeper introduction, examples, and environment setup guides in
|
[More examples](https://examples.deno.land/).
|
||||||
the [manual](https://deno.land/manual).
|
|
||||||
|
|
||||||
The complete API reference is available at the runtime
|
### Additional Resources
|
||||||
[documentation](https://doc.deno.land).
|
|
||||||
|
- **[The Deno Manual](https://deno.land/manual)** is a great starting point for
|
||||||
|
[additional examples](https://deno.land/manual/examples),
|
||||||
|
[setting up your environment](https://deno.land/manual/getting_started/setup_your_environment),
|
||||||
|
[using npm](https://deno.land/manual/node), and more.
|
||||||
|
- **[Runtime API reference](https://deno.land/api)** documents all APIs built
|
||||||
|
into Deno CLI.
|
||||||
|
- **[Deno Standard Modules](https://deno.land/std)** do not have external
|
||||||
|
dependencies and are reviewed by the Deno core team.
|
||||||
|
- **[deno.land/x](https://deno.land/x)** is the registry for third party
|
||||||
|
modules.
|
||||||
|
- **[Blog](https://deno.com/blog)** is where the Deno team shares important
|
||||||
|
product updates and "how to"s, about solving technical problems.
|
||||||
|
|
||||||
### Contributing
|
### Contributing
|
||||||
|
|
||||||
|
@ -100,5 +109,9 @@ To contribute, please read our
|
||||||
|
|
||||||
[Build Status - Cirrus]: https://github.com/denoland/deno/workflows/ci/badge.svg?branch=main&event=push
|
[Build Status - Cirrus]: https://github.com/denoland/deno/workflows/ci/badge.svg?branch=main&event=push
|
||||||
[Build status]: https://github.com/denoland/deno/actions
|
[Build status]: https://github.com/denoland/deno/actions
|
||||||
[Twitter badge]: https://twitter.com/intent/follow?screen_name=deno_land
|
[Twitter badge]: https://img.shields.io/twitter/follow/deno_land.svg?style=social&label=Follow
|
||||||
[Twitter handle]: https://img.shields.io/twitter/follow/deno_land.svg?style=social&label=Follow
|
[Twitter link]: https://twitter.com/intent/follow?screen_name=deno_land
|
||||||
|
[YouTube badge]: https://img.shields.io/youtube/channel/subscribers/UCqC2G2M-rg4fzg1esKFLFIw?style=social
|
||||||
|
[YouTube link]: https://www.youtube.com/@deno_land
|
||||||
|
[Discord badge]: https://img.shields.io/discord/684898665143206084?logo=discord&style=social
|
||||||
|
[Discord link]: https://discord.gg/deno
|
||||||
|
|
Loading…
Reference in a new issue