Updating README.md
This commit is contained in:
parent
b45d66a074
commit
d05ba3c4ed
41
README.md
41
README.md
@ -56,14 +56,24 @@ Every request consists of a JSON-encoded object containing an `action`, a `versi
|
|||||||
simple example of a modern JavaScript application communicating with the extension is illustrated below:
|
simple example of a modern JavaScript application communicating with the extension is illustrated below:
|
||||||
|
|
||||||
```JavaScript
|
```JavaScript
|
||||||
function ankiInvoke(action, version, params={}) {
|
function ankiConnectInvoke(action, version, params={}) {
|
||||||
return new Promise((resolve, reject) => {
|
return new Promise((resolve, reject) => {
|
||||||
const xhr = new XMLHttpRequest();
|
const xhr = new XMLHttpRequest();
|
||||||
xhr.addEventListener('loadend', () => {
|
xhr.addEventListener('error', () => reject('failed to connect to AnkiConnect'));
|
||||||
if (xhr.responseText) {
|
xhr.addEventListener('load', () => {
|
||||||
resolve(JSON.parse(xhr.responseText));
|
try {
|
||||||
} else {
|
const response = JSON.parse(xhr.responseText);
|
||||||
reject('unable to connect to plugin');
|
if (response.error) {
|
||||||
|
throw response.error;
|
||||||
|
} else {
|
||||||
|
if (response.hasOwnProperty('result')) {
|
||||||
|
resolve(response.result);
|
||||||
|
} else {
|
||||||
|
reject('failed to get results from AnkiConnect');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
reject(e);
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
@ -73,10 +83,10 @@ function ankiInvoke(action, version, params={}) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
try {
|
try {
|
||||||
const response = await ankiInvoke('deckNames', 5);
|
const result = await ankiConnectInvoke('deckNames', 5);
|
||||||
window.alert(`detected decks: ${response.result}`);
|
console.log(`got list of decks: ${result}`);
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
window.alert(`error getting decks: ${response.error}`);
|
console.log(`error getting decks: ${e}`);
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
@ -528,7 +538,8 @@ guarantee that your application continues to function properly in the future.
|
|||||||
AnkiConnect can download audio files and embed them in newly created notes. The corresponding *audio* note member is
|
AnkiConnect can download audio files and embed them in newly created notes. The corresponding *audio* note member is
|
||||||
optional and can be omitted. If you choose to include it, the *url* and *filename* fields must be also defined. The
|
optional and can be omitted. If you choose to include it, the *url* and *filename* fields must be also defined. The
|
||||||
*skipHash* field can be optionally provided to skip the inclusion of downloaded files with an MD5 hash that matches
|
*skipHash* field can be optionally provided to skip the inclusion of downloaded files with an MD5 hash that matches
|
||||||
the provided value. This is useful for avoiding the saving of error pages and stub files.
|
the provided value. This is useful for avoiding the saving of error pages and stub files. The *fields* member is a
|
||||||
|
list of fields that should play audio when the card is displayed in Anki.
|
||||||
|
|
||||||
*Sample request*:
|
*Sample request*:
|
||||||
```
|
```
|
||||||
@ -540,15 +551,16 @@ guarantee that your application continues to function properly in the future.
|
|||||||
"modelName": "Basic",
|
"modelName": "Basic",
|
||||||
"fields": {
|
"fields": {
|
||||||
"Front": "front content",
|
"Front": "front content",
|
||||||
"Back": "back content",
|
"Back": "back content"
|
||||||
},
|
},
|
||||||
"tags": [
|
"tags": [
|
||||||
"yomichan",
|
"yomichan"
|
||||||
],
|
],
|
||||||
"audio": {
|
"audio": {
|
||||||
"url": "https://assets.languagepod101.com/dictionary/japanese/audiomp3.php?kanji=猫&kana=ねこ",
|
"url": "https://assets.languagepod101.com/dictionary/japanese/audiomp3.php?kanji=猫&kana=ねこ",
|
||||||
"filename": "yomichan_ねこ_猫.mp3",
|
"filename": "yomichan_ねこ_猫.mp3",
|
||||||
"skipHash": "7e2c2f954ef6051373ba916f000168dc"
|
"skipHash": "7e2c2f954ef6051373ba916f000168dc",
|
||||||
|
"fields": "Front"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -585,7 +597,8 @@ guarantee that your application continues to function properly in the future.
|
|||||||
"audio": {
|
"audio": {
|
||||||
"url": "https://assets.languagepod101.com/dictionary/japanese/audiomp3.php?kanji=猫&kana=ねこ",
|
"url": "https://assets.languagepod101.com/dictionary/japanese/audiomp3.php?kanji=猫&kana=ねこ",
|
||||||
"filename": "yomichan_ねこ_猫.mp3",
|
"filename": "yomichan_ねこ_猫.mp3",
|
||||||
"skipHash": "7e2c2f954ef6051373ba916f000168dc"
|
"skipHash": "7e2c2f954ef6051373ba916f000168dc",
|
||||||
|
"fields": "Front"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
|
Loading…
Reference in New Issue
Block a user