Updating README.md

This commit is contained in:
Alex Yatskov 2017-09-09 22:28:09 -07:00
parent b45d66a074
commit d05ba3c4ed

View File

@ -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"
} }
} }
] ]