<p align="center">
  <a href="https://github.com/pirix-gh/eledoc">
    <img alt="logo" title="eledoc" src="https://raw.githubusercontent.com/pirix-gh/eledoc/master/.github/logo.png" width="300">
  </a>

  <h3 align="center">eledoc</h3>

  <p align="center">
    🌒 A material dark theme for TypeDoc
    <br>
    <br>
    <a href="#demo">🎮 View Demo</a>
    ·
    <a href="https://github.com/pirix-gh/eledoc/issues/new?template=---bug-report.md">🐞 Report Bug</a>
    ·
    <a href="https://github.com/pirix-gh/eledoc/issues/new?template=---feature-request.md">🍩 Request Feature</a>
    ·
    <a href="https://github.com/pirix-gh/eledoc/issues/new?template=---question.md">🤔  Ask Questions</a>
  </p>
</p>

<p align="center">
  <a href="https://gitter.im/eledoc-/community?utm_source=share-link&utm_medium=link&utm_campaign=share-link" target="_blank">
    <img src="https://img.shields.io/gitter/room/eledoc-/community.svg">
  </a>
  <a href="https://www.npmjs.com/package/eledoc" target="_blank">
    <img src="https://img.shields.io/npm/v/eledoc.svg">
  </a>
  <a href="#">
    <img src="https://img.shields.io/npm/dm/eledoc.svg">
  </a>
  <a href="http://makeapullrequest.com" target="_blank">
    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg">
  </a>
  <a href="#">
    <img src="https://img.shields.io/npm/l/eledoc.svg">
  </a>
</p>

## Table of Contents

* [📜 About](#-about)
* [🍩 Features](#-features)
* [🏁 Getting started](#-getting-started)
* [🧠 Good to know](#-good-to-know-)
* [🎁 Contributing](#-contributing)
* [👏 Sponsoring issues](#-sponsoring-issues)
* [🔮 What's next](#-whats-next)
* [🙏 Acknowledgements](#-acknowledgements)

## 📜 About

**eledoc** is a delightful dark theme for TypeDoc

#### Goals

* Provide a nice user experience
* Proper layout with visual cues
* Fix problems from usual themes

## 🍩 Features

* All the features from the default typedoc themes
* Create sections with `@[tag-name]` in doc comments

<p align="center">
  <img src="https://raw.githubusercontent.com/pirix-gh/eledoc/master/.github/demo.gif" id="demo">
<p align="center">

## 🏁 Getting Started

#### Prerequisites

```sh
npm install typedoc --save-dev
```

#### Installation

```sh
npm install eledoc --save-dev
```

#### Hello World

With the command line

```sh
npx typedoc --out docs src --theme node_modules/eledoc/bin/default/
```

Or in your `package.json`

```ts
"scripts": {
  "build:docs": "typedoc --out docs src --theme node_modules/eledoc/bin/default/",
}
```

## [🧠 Good to Know ⤢](https://github.com/pirix-gh/eledoc/issues?q=label%3Aquestion+sort%3Areactions-%2B1-desc)

In this wiki, you'll find some extra resources for your learning & understanding.

It is incremental and it will be completed on demand, you can ask for this below.

#### [Questions ⤢](https://github.com/pirix-gh/eledoc/issues?q=label%3Aquestion+sort%3Areactions-%2B1-desc)

Are you missing something? Participate to the open-wiki by posting your
questions [right here](https://github.com/pirix-gh/eledoc/issues/new?template=---question.md).

## 🎁 Contributing

Contributions are what make the open source community such an amazing place to
learn, inspire, and create. Any contributions you make are **greatly appreciated**.
There are many ways to contribute to the project:

#### Community
* [Help the community with answers on Gitter](https://gitter.im/eledoc-/community?utm_source=share-link&utm_medium=link&utm_campaign=share-link)
* [Reporting bugs or requesting new features](https://github.com/pirix-gh/eledoc/issues/new/choose)

#### Pull Requests
1. [Read the tutorial](https://medium.com/free-code-camp/typescript-curry-ramda-types-f747e99744ab)
2. Fork the project
3. Clone your fork
4. Create a pr/**feature** branch
   ```sh
   git checkout -b pr/CoolFeature
   ```
5. Commit your changes
   ```sh
   git commit -m 'Added this CoolFeature'
   ```
6. [Run the tests](#-running-tests)
7. Commit your changes
   ```sh
   git push origin pr/CoolFeature
   ```
8. Open a pull request

## 👏 Sponsoring issues

**Sponsored issues have higher priority over non-critical issues**.<br>

You can either request a new feature or a bug fix then fund it.

<a href="https://issuehunt.io/r/pirix-gh/eledoc">
  <img
  src="https://raw.githubusercontent.com/pirix-gh/eledoc/master/.github/issuehunt-logo.svg?sanitize=true">
</a>
<br>
<br>

**The money will be transparently split with an issue's assignees.**

## 🔮 What's next

* Re-write with React

## 🙏 Acknowledgements

Many, many thanks to all the
[contributors](https://github.com/pirix-gh/eledoc/graphs/contributors)

## 💟 Friendly Projects
* [`ts-toolbelt`](https://github.com/pirix-gh/ts-toolbelt) - 👷 Higher type safety for TypeScript
