# loppo

**Repository Path**: MicroPeople/loppo

## Basic Information

- **Project Name**: loppo
- **Description**: an extremely easy static site generator of markdown documents.Forked from https://github.com/ruanyf/loppo
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://github.com/ruanyf/loppo
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-01-10
- **Last Updated**: 2022-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Loppo is an extremely easy static site generator of markdown documents. You get your site with only one command. Please visit [demo](http://redux.ruanyifeng.com/).

## Features

- easy config ([example](https://raw.githubusercontent.com/ruanyf/loppo/master/loppo.yml.default))
- simple site structure ([example](https://raw.githubusercontent.com/ruanyf/redux-docs/master/chapters.yml))
- friendly template syntax([example](https://raw.githubusercontent.com/ruanyf/redux-docs/master/themes/oceandeep/page.template))
- built-in [utility commands](docs/sub-commands.md)

## How to use

**Attention: Loppo is still in its very early stages. Use it in production at your own risk.**

First of all, arrange your documents into the following structure.

```
|- myProject
   |- README.md
   |- docs
      |- page1.md
      |- page2.md
      |- ...
```

Now, install Loppo.

```bash
$ npm install loppo -g
```

Enter your project directory.

```bash
$ cd myProject
```

Run the command.

```bash
$ loppo
```

Now, Loppo will build the document site under `dist` sub-directory. After the building process, you could open the site in your browser.

```bash
$ open dist/index.html
```

## License

GPL v3