mirror of
https://scm.univ-tours.fr/22107988t/rappaurio-sae501_502.git
synced 2025-08-31 22:05:59 +02:00
permet l'ajout des frameworks et des routes
This commit is contained in:
143
app/node_modules/wikijs/README.md
generated
vendored
Normal file
143
app/node_modules/wikijs/README.md
generated
vendored
Normal file
@@ -0,0 +1,143 @@
|
||||
<img height="150" src="img/wikijs.png">
|
||||
|
||||
[](https://www.npmjs.com/package/wikijs)
|
||||
[](https://travis-ci.org/dijs/wiki)
|
||||
[](https://coveralls.io/r/dijs/wiki)
|
||||
|
||||
<a href="https://www.buymeacoffee.com/2tmRKi9" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-yellow.png" alt="Buy Me A Coffee" height="41" width="174"></a>
|
||||
|
||||
WikiJs is a node.js library which serves as an interface to Wikipedia (or any MediaWiki).
|
||||
|
||||
## What can it do?
|
||||
|
||||
- Search wiki articles
|
||||
- Fetch article content
|
||||
- Find all links/images/categories in a article page
|
||||
- Get parsed information about articles
|
||||
- Find articles by geographical location
|
||||
- and much more!
|
||||
|
||||
## Documentation
|
||||
|
||||
<https://dijs.github.io/wiki>
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
npm install wikijs
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
```javascript
|
||||
import wiki from 'wikijs';
|
||||
// const wiki = require('wikijs').default;
|
||||
|
||||
wiki()
|
||||
.page('Batman')
|
||||
.then(page => page.info('alterEgo'))
|
||||
.then(console.log); // Bruce Wayne
|
||||
```
|
||||
|
||||
## Build yourself
|
||||
|
||||
You can run these commands in order to build and test WikiJs:
|
||||
|
||||
```bash
|
||||
git clone git@github.com:dijs/wiki.git
|
||||
cd wiki
|
||||
npm install
|
||||
npm run build
|
||||
npm test
|
||||
```
|
||||
|
||||
## Usage with webpack
|
||||
|
||||
In order for webpack to build wikijs properly, you must add an option to
|
||||
your webpack configuration file. [Documentation](https://webpack.js.org/configuration/externals/#externals)
|
||||
|
||||
```json
|
||||
externals: {
|
||||
"isomorphic-fetch": "fetch"
|
||||
}
|
||||
```
|
||||
|
||||
## Usage with other MediaWiki's
|
||||
|
||||
You can use the API options configuration:
|
||||
|
||||
```js
|
||||
wiki({
|
||||
apiUrl: 'https://awoiaf.westeros.org/api.php',
|
||||
origin: null
|
||||
}).search('Winterfell');
|
||||
```
|
||||
|
||||
## Usage with other languages
|
||||
|
||||
You just need to change the API to the proper URL. This is normally just changing the subdomain of wikipedia.
|
||||
|
||||
```js
|
||||
wiki({ apiUrl: 'https://es.wikipedia.org/w/api.php' })
|
||||
.page('Cristiano Ronaldo')
|
||||
.then(page => page.info())
|
||||
.then(console.log);
|
||||
```
|
||||
|
||||
Read more about Cross Domain Requests [here](https://www.mediawiki.org/wiki/API:Main_module)
|
||||
|
||||
## Usage with custom headers
|
||||
|
||||
If you need to pass authentication headers or anything else.
|
||||
|
||||
```js
|
||||
wiki({
|
||||
headers: {
|
||||
Cookie: 'name=value; name2=value2; name3=value3'
|
||||
}
|
||||
}).search('Winterfell');
|
||||
```
|
||||
|
||||
## Chain data requests together for more efficient applications
|
||||
|
||||
Query a specific page:
|
||||
|
||||
```js
|
||||
wiki()
|
||||
.page('albert einstein')
|
||||
.then(page =>
|
||||
page
|
||||
.chain()
|
||||
.summary()
|
||||
.image()
|
||||
.links()
|
||||
.request()
|
||||
);
|
||||
```
|
||||
|
||||
Or query many pages at once:
|
||||
|
||||
```js
|
||||
wiki()
|
||||
.chain()
|
||||
.geosearch(52.52437, 13.41053)
|
||||
.summary()
|
||||
.image()
|
||||
.coordinates()
|
||||
.request();
|
||||
```
|
||||
|
||||
## Parsing Wiki Infobox Data
|
||||
|
||||
The code Wikipedia uses for infobox data is strange and complex. So I have split the parsing code into another library. You can find it [here](https://github.com/dijs/infobox-parser).
|
||||
[](https://www.npmjs.com/package/infobox-parser)
|
||||
|
||||
We not only parse out the information, but also try to transform the data into a convenient structure for data processing.
|
||||
|
||||
## Contribute!
|
||||
|
||||
I always welcome help. Please just stick to the lint rules and write tests with each feature/fix.
|
||||
|
||||
## Artwork
|
||||
|
||||
Thanks to [Heather van der Dys](http://heathervanderdys.com/) for the awesome logo!
|
Reference in New Issue
Block a user