Difference between revisions of "Multipage"

From Inkscape Wiki
Jump to navigation Jump to search
(Fix typos, grammar and repair a broken link in the "Pages Tool" section.)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Multipage support ==
Multi-page feature was added in [[Release notes/1.2|Inkscape 1.2]]. Its front end was implemented as a new Pages Tool in the toolbar. Pages are saved to an SVG document in the <code>namedview</code> tag as custom, Inkscape-specific elements (which do not work on the web and are not part of the SVG standard).


Currently, Inkscape does '''not''' have multipage support. The main reason is that the current SVG standard does not support multipage documents. This feature was proposed in the SVG revision 1.2, but for now got dropped in the next coming version SVG 2.0.
The first page serves as the SVG viewbox.


[[http://wiki.inkscape.org/wiki/index.php/SVG_WorkingGroup#Multipage_document_support SVG 2.0 draft on multiple pages]]
=== Pages Tool ===
The new Pages Tool (lowest button in the toolbar) allows you to create multi-page Inkscape documents, and to import as well as export multi-page PDF documents. (MR #3486, MR #3785, MR #3821). It supports overlapping pages and pages of different sizes in a single document.


[[http://www.w3.org/TR/2004/WD-SVG12-20041027/multipage.html SVG 1.2 proposal for multiple pages]].
==== Importing ====
Multi-page documents can be imported with their pages appended as new pages in the existing document. Select the correct option in the window that pops up to append pages rather than import shapes as usual. This can be used to merge multiple PDF files.


This page discusses how the feature can (or should) be implemented:
Saving a multi-page document to a format capable of storing multiple pages (e.g., PDF) will automatically save all pages.
Exporting individual pages can be done in the new export dialog in batch mode. It is also possible to export each individual page in the Single export tab. Use this to split SVG or PDF documents into individual pages. ''Note: it's not yet possible to select a sub-selection of multiple pages to export.''


* There should be multiple pages within a document.
'''Tool usage:'''
* There are two contrary implementations in the real world:
** distribute pages around the graphics elements - the Adobe way
** distribute graphics elements around the pages - how Corel does it and how SVG proposes to do it
* New problems arise when saving to singlepage file formats (jpg, png, etc).


== Multipage in the SVG 1.2 standard (dropped) ==
* To '''create a new page''' either:
* All pages are contained within a single pageSet element. A pageSet may contain any number of page elements. Each page element defines a single container of graphical objects.
** click-and-drag on the canvas, or
* In a screen-based user agent, only one page element is displayed at any time on the main canvas.
** click on the 'Create a new page' button in the tool controls.
* The SVG content typically defines a page dimension or aspect ratio in the topmost svg element and its viewBox. The viewBox transformation applies to printed SVG in the same way as screen display.
* To '''delete a page''', click on the page to select it, then click on the button <code>Delete selected page</code> or use the <code>Delete</code> or <code>Backspace</code> keys.
* The orientation of each page element can be controlled by the page-orientation property. This enables the content to define whether a portrait or landscape mode is used for display and printing.
* To '''move a page''' on the canvas, click-and-drag it to the desired new position. If the option to <code>Move overlapping objects</code> is active, this will move any objects that touch the page along with it.
* To '''change a page's size''':
** click on a page whose size you want to change to select it, then drag a square-shaped handle in one of the corners, or
** click on a page, then choose one of the predefined sizes in the page size dropdown, or enter your dimensions for the 'Custom' option, by typing them into the field in the format <code>10cm x 15cm</code>.
* In order to '''fit a page''' to:
** the size of '''the drawing''': make sure to have no object selected before you switch to the Pages tool. Then select a page by clicking on it, then click on the button 'Fit page to drawing or selection' in the tool controls;
** '''a selected object''': first select the object(s) with the selection tool, then switch to the Pages tool, click on a page to select it, then press the the button 'Fit page to drawing or selection' in the tool controls.
* To '''add a label''' to your page, select the page by clicking on it, then enter a name or label for it into the text field in the page tool's controls. Labels are always visible, no matter which tool is currently selected.
* To '''export a multi-page PDF''' file, use <code>File → Save a copy … → PDF</code>. This will automatically include all pages. If you only want to export a certain page, or a selection of pages, the updated [[Release notes/1.2#Export%20Dialog|<code>File → Export</code> dialog]]'s batch export tab can help you get that done (one file per page).
* To export pages as separate documents, use the Export dialog.
* To '''open or import a multi-page PDF or AI (pdf-based)''' file, use <code>File → Open/Import → select file name → choose to import 'All' pages</code> [Known issue: 'import' moves content of some pages to some far-out place in the drawing]
* You can navigate pages with page navigator which will show up in right down corner of status bar


== Multipage à la Corel ==
''Note: Multi-page SVG files are an Inkscape-specific concept. Web browsers will only display the first page of your document, which corresponds to the 'viewbox' area of the SVG file.''
* There is a list of pages as tabs on the lower side of the drawing window.
[[File:Inkscape o2RwP02rKw.gif|none|thumb|487x487px|multipage ]]
* All pages share the same page properties.
* A '''master page''' contains elements that are visible on all other pages: drawings, markers
* In an object browser, pages and layers are integrated.


See [[http://wiki.inkscape.org/wiki/images/Corel_pages.PNG this screeshot]].


== Multicanvas (similar to multi-Artboard on adobe illustrator cs4). ==
==Multipage in the SVG 1.2 standard (dropped) ==
Multicanvas solution is not the same as pages and can't follow the SVG pageSet spec. The multicanvas, as the multi-artboard, can (frequently must) have different sizes and can be freely placed on the 2D space. A canvas may overlap a part other canvas.
*All pages are contained within a single pageSet element. A pageSet may contain any number of page elements. Each page element defines a single container of graphical objects.
 
* In a screen-based user agent, only one page element is displayed at any time on the main canvas.
Each canvas can be printed independently and that feature helps to unify the art conception for the most applications of an art project.
*The SVG content typically defines a page dimension or aspect ratio in the topmost svg element and its viewBox. The viewBox transformation applies to printed SVG in the same way as screen display.
*The orientation of each page element can be controlled by the page-orientation property. This enables the content to define whether a portrait or landscape mode is used for display and printing.


* see this adobe tutorial [[http://www.adobe.com/designcenter/illustrator/articles/lrvid4016_ai.html here]]
==Inkscape-pages extension ==
* there is an [[http://www.vimeo.com/2503097 video]] by Valessio Brito presenting an UI mockup how multipage can be handled in inkscape
 
The multicanvas feature may be incompatible with the multipage feature, so, the user may chose the working mode on the "document properties" dialog. The default must be multipage and that will show the page tabs on the interface and the "new page" button, when selecting multicanvas that will show the canvas controls and the "new canvas" button.
 
Feature request registered: https://bugs.launchpad.net/inkscape/+bug/671081
 
== Inkscape-pages extension ==


Developer lixapopescu created a inkscape extension in 2011 which hacked into inkscape some multi page support. https://sourceforge.net/projects/inkscape-pages/
Developer lixapopescu created a inkscape extension in 2011 which hacked into inkscape some multi page support. https://sourceforge.net/projects/inkscape-pages/


The design is based on using layers as the basis for pages and it's a useful hack if the svg specification will always not include pages.
The design is based on using layers as the basis for pages and it's a useful hack if the svg specification will always not include pages.
== Implementation ==
* Some planning was done in [http://www.nabble.com/Multipage-plan-td16394431.html this thread]. BROKEN LINK
* All export dialogues must get extra properties in order to handle multiple pages, e.g. for specifying not only the elements, but also the pages to be exported.
* Some prelim work has landed: https://gitlab.com/inkscape/inkscape/commit/a6162e760c7eab68fc65a4ccc879e73ab0c20c1b

Latest revision as of 22:11, 30 July 2022

Multi-page feature was added in Inkscape 1.2. Its front end was implemented as a new Pages Tool in the toolbar. Pages are saved to an SVG document in the namedview tag as custom, Inkscape-specific elements (which do not work on the web and are not part of the SVG standard).

The first page serves as the SVG viewbox.

Pages Tool

The new Pages Tool (lowest button in the toolbar) allows you to create multi-page Inkscape documents, and to import as well as export multi-page PDF documents. (MR #3486, MR #3785, MR #3821). It supports overlapping pages and pages of different sizes in a single document.

Importing

Multi-page documents can be imported with their pages appended as new pages in the existing document. Select the correct option in the window that pops up to append pages rather than import shapes as usual. This can be used to merge multiple PDF files.

Saving a multi-page document to a format capable of storing multiple pages (e.g., PDF) will automatically save all pages. Exporting individual pages can be done in the new export dialog in batch mode. It is also possible to export each individual page in the Single export tab. Use this to split SVG or PDF documents into individual pages. Note: it's not yet possible to select a sub-selection of multiple pages to export.

Tool usage:

  • To create a new page either:
    • click-and-drag on the canvas, or
    • click on the 'Create a new page' button in the tool controls.
  • To delete a page, click on the page to select it, then click on the button Delete selected page or use the Delete or Backspace keys.
  • To move a page on the canvas, click-and-drag it to the desired new position. If the option to Move overlapping objects is active, this will move any objects that touch the page along with it.
  • To change a page's size:
    • click on a page whose size you want to change to select it, then drag a square-shaped handle in one of the corners, or
    • click on a page, then choose one of the predefined sizes in the page size dropdown, or enter your dimensions for the 'Custom' option, by typing them into the field in the format 10cm x 15cm.
  • In order to fit a page to:
    • the size of the drawing: make sure to have no object selected before you switch to the Pages tool. Then select a page by clicking on it, then click on the button 'Fit page to drawing or selection' in the tool controls;
    • a selected object: first select the object(s) with the selection tool, then switch to the Pages tool, click on a page to select it, then press the the button 'Fit page to drawing or selection' in the tool controls.
  • To add a label to your page, select the page by clicking on it, then enter a name or label for it into the text field in the page tool's controls. Labels are always visible, no matter which tool is currently selected.
  • To export a multi-page PDF file, use File → Save a copy … → PDF. This will automatically include all pages. If you only want to export a certain page, or a selection of pages, the updated File → Export dialog's batch export tab can help you get that done (one file per page).
  • To export pages as separate documents, use the Export dialog.
  • To open or import a multi-page PDF or AI (pdf-based) file, use File → Open/Import → select file name → choose to import 'All' pages [Known issue: 'import' moves content of some pages to some far-out place in the drawing]
  • You can navigate pages with page navigator which will show up in right down corner of status bar

Note: Multi-page SVG files are an Inkscape-specific concept. Web browsers will only display the first page of your document, which corresponds to the 'viewbox' area of the SVG file.

multipage


Multipage in the SVG 1.2 standard (dropped)

  • All pages are contained within a single pageSet element. A pageSet may contain any number of page elements. Each page element defines a single container of graphical objects.
  • In a screen-based user agent, only one page element is displayed at any time on the main canvas.
  • The SVG content typically defines a page dimension or aspect ratio in the topmost svg element and its viewBox. The viewBox transformation applies to printed SVG in the same way as screen display.
  • The orientation of each page element can be controlled by the page-orientation property. This enables the content to define whether a portrait or landscape mode is used for display and printing.

Inkscape-pages extension

Developer lixapopescu created a inkscape extension in 2011 which hacked into inkscape some multi page support. https://sourceforge.net/projects/inkscape-pages/

The design is based on using layers as the basis for pages and it's a useful hack if the svg specification will always not include pages.