Steven Silvester 8 rokov pred
rodič
commit
b3b080a1f7
2 zmenil súbory, kde vykonal 28 pridanie a 25 odobranie
  1. 11 10
      tutorial/extensions_dev.md
  2. 17 15
      tutorial/extensions_user.md

+ 11 - 10
tutorial/extensions_dev.md

@@ -72,29 +72,30 @@ listeners to react to changes in an observed object.
 An Extension is a valid npm package that meets the following criteria:
   - Exports one or more Phosphor plugins as the default export in its 
     main file.
-  - Has a ``jupyterlab`` key in its ``package.json`` which has 
-    ``"extension": true`` metadata.
+  - Has a `jupyterlab` key in its `package.json` which has 
+    `"extension": true` metadata.
 
 While authoring the extension, you can use the command:
 
-..
-  jupyter labextension link <path>
+```
+jupyter labextension link <path>
+```
 
 This causes the builder to re-install the source folder before building
 the application files.
 
-You can also use ``jupyter labextension install <path>``, but that will
+You can also use `jupyter labextension install <path>`, but that will
 only copy the current contents of the source folder.
 
 Note that the application is built against **released** versions of the
 core JupyterLab extensions.  If your extension depends on JupyterLab
 extensions, it should be compatible with the versions used in the
-``jupyterlab/package.json`` entry point file.
+`jupyterlab/package.json` entry point file.
 
 The package should export EMCAScript 5 compatible JavaScript.  It can 
-import CSS using the syntax ``require('foo.css')``.  The CSS files
+import CSS using the syntax `require('foo.css')`.  The CSS files
 can also import CSS from other packages using the syntax 
-``@import url('~foo/index.css')``, where ``foo`` is the name of the package.
+`@import url('~foo/index.css')`, where `foo` is the name of the package.
 
 The following file types are also supported (both in JavaScript and CSS):
 json, html, jpg, png, gif, svg, js.map, woff2, ttf, eot.
@@ -106,8 +107,8 @@ EMCAScript 5 it must be converted using an appropriate tool.
 The package must only rely on other packages that are bundled with your extension or available on npm.org.
 
 If you publish your extension on npm.org, users will be able to 
-install it as simply ``jupyter labextension install <foo>``, where
-``<foo>`` is the name of the published npm package.  You can alternatively
+install it as simply `jupyter labextension install <foo>`, where
+`<foo>` is the name of the published npm package.  You can alternatively
 provide a script that runs `jupyter labextension install` against a 
 local folder path on the user's machine or a provided tarball.  Any
 valid `npm install` specifier can be used in `jupyter labextension install`.

+ 17 - 15
tutorial/extensions_user.md

@@ -8,33 +8,35 @@ The base JupyterLab application comes with core set of extensions, which
 provide the Notebook, Terminal, Text Editor, etc.  New extensions can be 
 installed into the application using the command:
 
-::
- jupyter labextension install <foo>
+```
+jupyter labextension install <foo>
+```
 
-Where ``<foo>`` is a valid JupyterLab extension specifier.  This specifier
+Where `<foo>` is a valid JupyterLab extension specifier.  This specifier
 is defined by the extension author in their installation instructions.
 
 The currently installed extensions can be listed by running the command:
 
-::
- jupyter labextension list
-
+```
+jupyter labextension list
+```
 
 An installed extension can be uninstalled by running the command:
 
-::
- jupyter labextension <bar>
+```
+jupyter labextension <bar>
+```
 
-Where ``<bar>`` is the name of the extension, as printed in the extension
+Where `<bar>` is the name of the extension, as printed in the extension
 list.
 
 
 ## Advanced usage
 The behavior of the application can be customized through configuration.
-The configuration is stored in ``<sys-prefix>/etc/jupyter/labconfig/``.
-In this directory, we use ``build_config.json`` and ``page_config.json``.
-The ``build_config.json`` stores the location of the build directory in
-``location`` (defaults to ``<sys-prefix>/share/jupyter/lab``), as well
-as ``installed_extensions`` and ``linked_extensions`` metadata.
-The ``page_config.json`` data is used to provide config data to the application
+The configuration is stored in `<sys-prefix>/etc/jupyter/labconfig/`.
+In this directory, we use `build_config.json` and `page_config.json`.
+The `build_config.json` stores the location of the build directory in
+`location` (defaults to `<sys-prefix>/share/jupyter/lab`), as well
+as `installed_extensions` and `linked_extensions` metadata.
+The `page_config.json` data is used to provide config data to the application
 environment.  For example, the `ignoredPlugins` data is used to ignore registered plugins by the name of the token they provide.