shijing/README.md

诗经

![shijing](./shijing-logo.png)

# 诗经 | shijing

桃之夭夭，灼灼其华。 ---《国风.周南.桃夭》

[![Build Status](https://travis-ci.org/fluency03/shijing.svg?branch=master)](https://travis-ci.org/fluency03/shijing)
[![Version npm](https://img.shields.io/npm/v/shijing.svg)](https://www.npmjs.com/package/shijing)
[![Downloads npm](https://img.shields.io/npm/dt/shijing.svg)](https://www.npmjs.com/package/shijing)
[![MIT license](https://img.shields.io/npm/l/shijing.svg)](https://opensource.org/licenses/MIT)

## TODOs | 未完成

- English translation of the poem
- etc.


## API Reference | 接口

### shijing.start()

Start a REPL interface. | 开启一个 REPL 交互界面。

```javascript
诗经> shijing
'诗经'
```

### shijing.poem(key)

Return one poem based on the given `key`. | 基于`key`返回一首诗。

- `key`: *integer or number*, range 1 ~ 305. | *整数或数字*， 范围 1 ~ 305。


- *Return*: *object*, with properties of `title`, `chapter`, `section`, and `content`. Example:

  ```javascript
  {
    title: '葛覃',
    chapter: '国风',
    section: '周南',
    content: [
      '葛之覃兮，施于中谷，维叶萋萋。黄鸟于飞，集于灌木，其鸣喈喈。',
      '葛之覃兮，施于中谷，维叶莫莫。是刈是濩，为絺为绤，服之无斁。',
      '言告师氏，言告言归。薄污我私，薄浣我衣。害浣害否，归宁父母。'
    ]
  }
  ```


### shijing.random()

Randomly get one poem. | 随机返回一首诗。

- *Return*: *object*, with properties of `title`, `chapter`, `section`, and `content`. Example:

  ```javascript
  {
    title: '东方之日',
    chapter: '国风',
    section: '齐风',
    content: [
      '东方之日兮，彼姝者子，在我室兮。在我室兮，履我即兮。',
      '东方之月兮，彼姝者子，在我闼兮。在我闼兮，履我发兮。'
    ]
  }
  ```



  ### shijing.search(content)

Search poems based on given `content`. | 根据给定内容搜索诗词。

  - *Return*: *array*, an array of poem objects. Example:

    ```javascript
    [
      {
        title: '关雎',
        chapter: '国风',
        section: '周南',
        content: [
          '关关雎鸠，在河之洲。窈窕淑女，君子好逑。',
          '参差荇菜，左右流之。窈窕淑女，寤寐求之。',
          '求之不得，寤寐思服。悠哉悠哉，辗转反侧。',
          '参差荇菜，左右采之。窈窕淑女，琴瑟友之。',
          '参差荇菜，左右芼之。窈窕淑女，钟鼓乐之。'
        ]
      }
    ]
    ```



### shijing.emoji()

Randomly get a emoji. | 随机返回一个Emoji。

- *Return*: *object*, with properties of `key` and `emoji`. Example:

  ```javascript
  {
    key: 'thumbsup',
    emoji: '👍'
  }
  ```



## CLI Commands | 命令

Create a file `run.js` as simple as:

```javascript
var shijing = require("shijing");

shijing.start();
```

Then `node run.js`!

For all commands start with `.`, you can use TAB to output possible commands, like:

```
诗经> .
.break   .clear   .exit    .help    .save    .load    .editor  .一首      .心情
.编号      .清理      .再见
```


### shijing

```javascript
诗经> shijing
'诗经'
```

### 什么

```javascript
诗经> 什么
'诗经'
```

### .清理

Clear the content on the console screen. | 清理终端屏幕的内容。


### .再见

Close the REPL. | 关闭 REPL 交互环境。

```javascript
诗经> .再见
再见!
```




### .一首

Randomly display a poem. | 随机显示一篇诗文。


```javascript
诗经> .一首

国风.召南.甘棠
蔽芾甘棠，勿剪勿伐，召伯所茏。
蔽芾甘棠，勿剪勿败，召伯所憩。
蔽芾甘棠，勿剪勿拜，召伯所说。

诗经> .一首

国风.郑风.野有蔓草
野有蔓草，零露漙兮。有美一人，清扬婉兮。邂逅相遇，适我愿兮。
野有蔓草，零露瀼瀼。有美一人，婉如清扬。邂逅相遇，与子偕臧。

诗经> .一首

国风.郑风.山有扶苏
山有扶苏，隰有荷华。不见子都，乃见狂且。
山有乔松，隰有游龙，不见子充，乃见狡童。

诗经> .一首

国风.齐风.敝笱
敝笱在梁，其鱼鲂鳏。齐子归止，其从如云。
敝笱在梁，其鱼鲂鱮。齐子归止，其从如雨。
敝笱在梁，其鱼唯唯。齐子归止，其从如水。

诗经> .一首

小雅.鹿鸣之什.皇皇者华
皇皇者华，于彼原隰。駪駪征夫，每怀靡及。
我马维驹，六辔如濡。载驰载驱，周爰咨诹。
我马维骐，六辔如丝。载驰载驱，周爰咨谋。
我马维骆，六辔沃若。载驰载驱，周爰咨度。
我马维骃，六辔既均。载驰载驱，周爰咨询。

诗经> .一首

国风.邶风.终风
终风且暴，顾我则笑，谑浪笑敖，中心是悼。
终风且霾，惠然肯来，莫往莫来，悠悠我思。
终风且曀，不日有曀，寤言不寐，愿言则嚏。
曀曀其阴，虺虺其雷，寤言不寐，愿言则怀。

诗经> .一首

国风.齐风.着
俟我于着乎而，充耳以素乎而，尚之以琼华乎而。
俟我于庭乎而，充耳以青乎而，尚之以琼莹乎而。
俟我于堂乎而，充耳以黄乎而，尚之以琼英乎而。

诗经> .一首

小雅.鸿雁之什.我行其野
我行其野，蔽芾其樗。婚姻之故，言就尔居。尔不我畜，复我邦家。
我行其野，言采其蓫。婚姻之故，言就尔宿。尔不我畜，言归斯复。
我行其野，言采其葍。不思旧姻，求尔新特。成不以富，亦祗以异。

诗经> .一首

国风.郑风.羔裘
羔裘如濡，洵直且侯。彼其之子，舍命不渝。
羔裘豹饰，孔武有力。彼其之子，邦之司直。
羔裘晏兮，三英粲兮。彼其之子，邦之彦兮。
```

### .编号

Display a poem based on given number. | 显示指定编号诗文。编号范围：`一 ～ 三百零五`。

```javascript
诗经> .编号 五十五

国风.卫风.淇奥
瞻彼淇奥，绿竹猗猗。有匪君子，如切如磋，如琢如磨，瑟兮僴兮，赫兮咺兮。有匪君子，终不可谖兮。
瞻彼淇奥，绿竹青青。有匪君子，充耳秀莹，会弁如星。瑟兮僴兮。赫兮咺兮，有匪君子，终不可谖兮。
瞻彼淇奥，绿竹如箦。有匪君子，如金如锡，如圭如璧。宽兮绰兮，猗重较兮。善戏谑兮，不为虐兮。

诗经> .编号 三十八

国风.邶风.简兮
简兮简兮，方将万舞。日之方中，在前上处。
硕人俣俣，公庭万舞。有力如虎，执辔如组。
左手执龠，右手秉翟。赫如渥赭，公言锡爵。
山有榛，隰有苓。云谁之思？西方美人。彼美人兮，西方之人兮。

诗经> .编号 十

国风.周南.汝坟
遵彼汝坟，伐其条枚。未见君子，惄如调饥。
遵彼汝坟，伐其条肄。既见君子，不我遐弃。
鲂鱼赪尾，王室如毁。虽则如毁，父母孔迩。

诗经> .编号 九十九

国风.齐风.东方之日
东方之日兮，彼姝者子，在我室兮。在我室兮，履我即兮。
东方之月兮，彼姝者子，在我闼兮。在我闼兮，履我发兮。

诗经> .编号 二百五十一

大雅.生民之什.泂酌
泂酌彼行潦，挹彼注兹，可以餴饎。岂弟君子，民之父母。
泂酌彼行潦，挹彼注兹，可以濯罍。岂弟君子，民之攸归。
泂酌彼行潦，挹彼注兹，可以濯溉。岂弟君子，民之攸墍。
```


### .搜索

Search poems based on given content. | 根据给定内容搜索诗词。

```javascript
诗经> .搜索 关雎

国风.周南.关雎
关关雎鸠，在河之洲。窈窕淑女，君子好逑。
参差荇菜，左右流之。窈窕淑女，寤寐求之。
求之不得，寤寐思服。悠哉悠哉，辗转反侧。
参差荇菜，左右采之。窈窕淑女，琴瑟友之。
参差荇菜，左右芼之。窈窕淑女，钟鼓乐之。

诗经> .搜索 葛覃

国风.周南.葛覃
葛之覃兮，施于中谷，维叶萋萋。黄鸟于飞，集于灌木，其鸣喈喈。
葛之覃兮，施于中谷，维叶莫莫。是刈是濩，为絺为绤，服之无斁。
言告师氏，言告言归。薄污我私，薄浣我衣。害浣害否，归宁父母。

诗经> .搜索 桃之夭夭

国风.周南.桃夭
桃之夭夭，灼灼其华。之子于归，宜其室家。
桃之夭夭，有蕡其实。之子于归，宜其家室。
桃之夭夭，其叶蓁蓁。之子于归，宜其家人。
```



### .心情

Randomly display an Emoji. | 随机显示一个Emoji。

```javascript
诗经> .心情
🐢
诗经> .心情
💖
诗经> .心情
🚝
诗经> .心情
🤘
诗经> .心情
🌓
诗经> .心情
🌯
诗经> .心情
🇳🇨
诗经> .心情
🇨🇺
诗经> .心情
🐩
诗经> .心情
🗽
诗经> .心情
🌙
诗经> .心情
🚿
```



## License

[MIT](https://github.com/fluency03/shijing/blob/master/LICENSE)





[npm-image]: https://img.shields.io/npm/v/express.svg
[npm-url]: https://www.npmjs.com/package/shijing
[downloads-image]: https://img.shields.io/npm/dm/express.svg
[downloads-url]: https://www.npmjs.com/package/shijing