Libros interactivosInteractive Workbooks

Puede usar los libros como una aplicación independiente, separada de su IDE.You can use Workbooks as a standalone application, separate from your IDE.

Para empezar a crear un nuevo libro, ejecute la aplicación Workbooks.To start creating a new workbook, run the Workbooks app. Si no ha instalado esto ya, visite la instalación página.If you haven't installed this already, visit the Installation page. Se le pedirá que cree un libro en la plataforma de elección, que se conectará automáticamente a una aplicación de agente, lo que le permite visualizar el documento en tiempo real.You will be prompted to create a workbook in your platform of choice, which will automatically connect to an agent app allowing you to visualize your document in real time.

Si ya se está ejecutando la aplicación Workbooks, puede crear un nuevo documento examinando archivo > nuevo.If the Workbooks app is already running, you can create a new document by browsing to File > New.

Los libros se pueden guardar y abrir de nuevo más tarde dentro de la aplicación.Workbooks can be saved and opened again later within the application. A continuación, puede compartirlos con otras personas para demostrar ideas, explore las nuevas API o enseñar a los nuevos conceptos.You can then share them with others to demonstrate ideas, explore new APIs, or teach new concepts.

Edición de códigoCode Editing

La ventana de edición de código proporciona la finalización de código, colores de sintaxis, inline live-diagnostics y compatibilidad de las instrucciones de varias líneas.The code editing window provides code completion, syntax coloring, inline live-diagnostics, and multi-line statement support.

Xamarin Workbooks se guardan en un .workbook archivo, que es un archivo CommonMark con algunos metadatos en la parte superior (consulte tipos de archivos de libros para obtener más detalles sobre cómo se pueden guardar libros).Xamarin Workbooks are saved in a .workbook file, which is a CommonMark file with some metadata at the top (see Workbooks File Types for more details on how workbooks can be saved).

Compatibilidad con paquetes de NuGetNuGet Package Support

Se admiten muchos paquetes conocidos de NuGet directamente en Xamarin Workbooks.Many popular NuGet packages are supported directly in Xamarin Workbooks. Puede buscar paquetes examinando archivo > Agregar paquete.You can search for packages by browsing to File > Add Package. Adición de un paquete introducirá automáticamente #r las instrucciones que hacen referencia a los ensamblados del paquete, lo que le permite usar de inmediato.Adding a package will automatically bring in #r statements referencing package assemblies, allowing you to use them right away.

Cuando se guarda un libro con las referencias de paquete, se guardan también esas referencias.When you save a workbook with package references, those references are saved as well. Si el libro se comparte con otra persona, se descargarán automáticamente los paquetes que se hace referencia.If you share the workbook with another person, it will automatically download the referenced packages.

Hay algunas limitaciones conocidas con compatibilidad con paquete de NuGet en los libros:There are some known limitations with NuGet package support in Workbooks:

  • Las bibliotecas nativas se admiten solo en iOS y solo cuando se vincula con la biblioteca administrada.Native libraries are supported only on iOS, and only when linked with the managed library.
  • Los paquetes que dependen de .targets archivos o secuencias de comandos de PowerShell probablemente no funcionará según lo previsto.Packages which depend on .targets files or PowerShell scripts will likely fail to work as expected.
  • Para quitar o modificar una dependencia del paquete, edite el manifiesto del libro con un editor de texto.To remove or modify a package dependency, edit the workbook's manifest with a text editor. Administración de paquetes correcto está en camino.Proper package management is on the way.

Compatibilidad de Xamarin.FormsXamarin.Forms Support

Si hace referencia el paquete Xamarin.Forms NuGet en su libro, la aplicación de libro cambiará su vista principal para que esté basado en Xamarin.Forms.If you reference the Xamarin.Forms NuGet package in your workbook, the workbook app will change its main view to be Xamarin.Forms-based. Puede tener acceso a él a través de Xamarin.Forms.Application.Current.MainPage.You can access it through Xamarin.Forms.Application.Current.MainPage.

La ficha Vista Inspector también tiene compatibilidad especial para mostrar la jerarquía de vistas de Xamarin.Forms que le ayudarán a comprender sus diseños.The View Inspector tab also has special support for showing the Xamarin.Forms view hierarchy to help you understand your layouts.

Rich Text EditingRich Text Editing

Puede editar el texto en torno a su código mediante el editor de texto enriquecido que incluye, como se muestra a continuación:You can edit the text around your code using the rich text editor included, as illustrated below:

Creación de markdownMarkdown Authoring

Los autores de libros a veces, resultará más fácil editar directamente el CommonMark "origen" del libro con su editor favorito.Workbook authors may sometimes find it easier to directly edit the CommonMark "source" of the workbook with their favorite editor.

Tenga en cuenta que si, a continuación, edite y guarde el libro en el cliente de los libros, el texto CommonMark puede volver a formatear.Be aware that if you then edit and save your workbook within the Workbooks client, your CommonMark text may be reformatted.

Tenga en cuenta que debido a la extensión CommonMark se usa para habilitar los metadatos YAML en archivos de libro, --- está reservado para ese propósito.Please note that due to the CommonMark extension we use to enable YAML metadata in workbook files, --- is reserved for that purpose. Si desea crear saltos temáticos en el texto, se debe usar *** o ___ en su lugar.If you wish to create thematic breaks in your text, you should use *** or ___ instead. Estos saltos deben evitarse en los libros 1.2 y anteriormente debido a un error durante la guarde.Such breaks should be avoided in Workbooks 1.2 and earlier due to a bug during save.

Mejoras en los libros 1.3Improvements in Workbooks 1.3

Hemos ampliado también la sintaxis de comillas de bloque de Markdown ligeramente para mejorar la presentación.We've also extended the Markdown block quote syntax slightly to improve presentation. Al agregar un emoji como el primer carácter de la cita en bloque, puede influir en el color de fondo de la oferta:By adding an emoji as the first character in your block quote, you can influence the background color of the quote:

  • > [!NOTE]

    se representará como una nota con un fondo azulwill render as a note with a blue background

  • > [!IMPORTANT]

    se representará como una advertencia con un fondo amarillowill render as a warning with a yellow background

  • > [!WARNING]

    se representará como un problema con un fondo rojowill render as a problem with a red background

También puede vincular a los encabezados del documento del libro.You can also link to headers in the Workbook document. Delimitadores para cada encabezado, se generan con el identificador de delimitador está el texto del encabezado, procesado como sigue:We generate anchors for each header, with the anchor ID being the header text, processed as follows:

  1. El encabezado está en minúsculas.The header is lower-cased.
  2. Se quitan todos los caracteres excepto los caracteres alfanuméricos y guiones.All characters except for alphanumerics and dashes are removed.
  3. Todos los espacios se sustituyen por guiones.All spaces are replaced with dashes.

Esto significa que un encabezado, como "Importante Header" Obtiene un identificador de important-header y se pueden vincular mediante la inserción de un vínculo a #important-header en el libro.This means that a header like "Important Header" gets an id of important-header and can be linked to by inserting a link to #important-header in the workbook.

Estructura del documentoDocument Structure

celdaCell

Unidad discreta de contenido, que representa el código ejecutable o markdown.A discrete unit of content, representing either executable code or markdown. Una celda de código está formada por un máximo de cuatro subcomponentes:A code cell is comprised of up to four sub-components:

  • EditorEditor
    • BúferBuffer
  • Diagnósticos de compiladorCompiler Diagnostics
  • Salida de la consolaConsole Output
  • Resultados de la ejecuciónExecution Results

EditorEditor

El componente de texto interactivo de una celda.The interactive text component of a cell. Para las celdas de código, este es el editor de código real con el resaltado de sintaxis, etcetera. Para las celdas de markdown es un editor de texto enriquecido contenido con un formato sensible al contexto y la barra de herramientas de creación.For code cells, this is the actual code editor with syntax highlighting, etc. For markdown cells this is a rich-text content editor with a context sensitive formatting and authoring toolbar.

BúferBuffer

El contenido de un editor de texto reales.The actual text content of an editor.

Diagnósticos de compiladorCompiler Diagnostics

Los diagnósticos se generan al compilar el código, presentan solo cuando se solicita la ejecución explícita.Any diagnostics produced when compiling code, rendered only when explicit execution is requested. Se muestra inmediatamente debajo del editor de la celda.Displayed immediately below the cell editor.

Salida de la consolaConsole Output

Cualquier salida se escriben en la salida estándar o un error estándar durante la ejecución de la celda.Any output written to standard out or standard error during the execution of the cell. Salida estándar que se representará en texto negro y error estándar se representará en texto rojo.Standard out will be rendered in black text and standard error will be rendered in red text.

Resultados de la ejecuciónExecution Results

Enriquecida e interactivas potencialmente representaciones de los resultados de una celda se representará tras la compilación se realizó correctamente, siempre que un resultado realmente generado por la ejecución.Rich and potentially interactive representations of results for a cell will be rendered upon successful compilation, provided a result is actually produced by execution. Las excepciones se consideran los resultados en este contexto, ya que se producen como resultado de ejecutar realmente la compilación.Exceptions are considered results in this context, since they are produced as a result of actually executing the compilation.

Tipos de archivos de librosWorkbooks Files Types

Archivos sin formatoPlain Files

De forma predeterminada, se guarda un libro como texto sin formato .workbook archivo que contiene el texto con formato CommonMark.By default, a workbook saves as a plain text .workbook file containing CommonMark-formatted text.

PaquetesPackages

Un paquete de libro es un directorio que se denomina con el .workbook extensión.A workbook package is a directory that is named with the .workbook extension. En Finder de Mac y en el cuadro de diálogo Abrir Xamarin Workbooks y el menú de archivos recientes, este directorio se reconocerá como si fuese un archivo.On Mac's Finder and in the Xamarin Workbooks open dialog and recent files menu, this directory will be recognized as if it were a file.

El directorio debe contener un index.workbook archivo, que es el libro de texto sin formato real que se cargarán en Xamarin Workbooks.The directory must contain an index.workbook file, which is the actual plain text workbook that will be loaded in Xamarin Workbooks. El directorio también puede contener recursos requeridos por index.workbook, incluidas imágenes u otros archivos.The directory can also contain resources required by index.workbook, including images or other files.

Si un texto sin formato .workbook se abre el archivo que hace referencia a los recursos desde el mismo directorio en los libros 0.99.3 o versiones posteriores, cuando se guarda, se convertirá en un .workbook paquete.If a plain text .workbook file that references resources from its same directory is opened in Workbooks 0.99.3 or later, when it is saved, it will be converted into a .workbook package. Esto es cierto en Mac y Windows.This is true on both Mac and Windows.

Nota

Los usuarios de Windows se abrirán el package.workbook\index.workbook archivo directamente, pero en caso contrario, el paquete comportará igual que en el equipo Mac.Windows users will open the package.workbook\index.workbook file directly, but otherwise the package will behave the same as on Mac.

Archivos de almacenamientoArchives

Paquetes de libro, que se va a directorios, pueden ser difíciles distribuir fácilmente a través de internet.Workbook packages, being directories, can be hard to distribute easily over the internet. La solución es archivos de libro.The solution is workbook archives. Un archivo de libro es un paquete comprimido en zip libro, denominado con el .workbook extensión.A workbook archive is a zip-compressed workbook package, named with the .workbook extension.

A partir de los libros 1.1, al guardar un paquete de libro, el cuadro de diálogo Guardar ofrece la posibilidad de guardar como un archivo en su lugar.Starting in Workbooks 1.1, when saving a workbook package, the Save dialog offers the choice of saving as an archive instead. Libros 1.0 tenían ninguna manera integrada de crear o guardar archivos.Workbooks 1.0 had no built-in way of creating or saving archives.

En los libros 1.0, cuando se abrió un archivo de libro, se convirtió en forma transparente en un paquete de libro y se ha perdido el archivo zip.In Workbooks 1.0, when a workbook archive was opened, it was transparently converted into a workbook package, and the zip file was lost. En los libros 1.1, sigue siendo el archivo zip.In Workbooks 1.1, the zip file remains. Cuando el usuario guarda el archivo, se reemplaza con un nuevo archivo zip.When the user saves the archive, it is replaced with a new zip file.

Puede crear un archivo de libro manualmente haciendo clic en un paquete de libro y seleccionar comprimir en Mac, o enviar a > carpeta comprimida (zip) en Windows.You can create a workbook archive manually by right-clicking a workbook package and selecting Compress on Mac, or Send To > Compressed (zipped) folder on Windows. A continuación, cambie el nombre el archivo zip para que tenga un .workbook la extensión de archivo.Then rename the zip file to have a .workbook file extension. Esto solo funciona con los paquetes de libro, archivos de libro no estándar.This only works with workbook packages, not plain workbook files.