
{"id":60,"date":"2017-08-24T19:21:13","date_gmt":"2017-08-24T19:21:13","guid":{"rendered":"https:\/\/pressbooks.palomar.edu\/guide\/chapter\/clone-a-book\/"},"modified":"2025-11-20T09:50:39","modified_gmt":"2025-11-20T17:50:39","slug":"clone-a-book","status":"publish","type":"chapter","link":"https:\/\/pressbooks.palomar.edu\/guide\/chapter\/clone-a-book\/","title":{"raw":"Clone a Book","rendered":"Clone a Book"},"content":{"raw":"Pressbooks enables you to easily \"clone\" or copy any public, openly licensed book from one Pressbooks network to another. When you clone a book to your own network, you create a copy of the original book. You can then revise, remix, and redistribute your copy however you like without affecting the original book.\n\nBook cloning enables a wide range of open pedagogical practices for both individuals and institutions. For example, cloning empowers students to collaborate on and improve 'living resources' that have been sustained over several iterations of a course, allows teachers<span style=\"font-size: 1em;\"> to duplicate and immediately begin personalizing books specifically for their students' needs, enables <\/span><span style=\"font-size: 1em;\">course chairs or program leads to quickly update shared course material (like syllabi) each semester without altering or destroying previous versions, and lets u<\/span><span style=\"font-size: 1em;\">niversities freely share public teaching and research materials they have developed for quick adoption and adaptation by others.<\/span>\n<h1><a id=\"howtocloneabook\" href=\"\"><\/a>Clone a Book<\/h1>\nYou can clone any Pressbooks book that has been made public on the web and is in the public domain or has been published with a Creative Commons license that permits the free distribution of derivatives. Private books or books published as all rights reserved or \"No Derivatives\" licenses cannot be cloned.\nTo clone a book:\n<ol>\n \t<li>Click the '<strong>Adapt a book<\/strong>' button in the main panel of your user dashboard\n- or -\nClick the button '<strong>+ Clone Book<\/strong>' in the top menu from anywhere in Pressbooks to get to the Clone a Book interface. <img class=\"alignnone wp-image-472 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2017\/08\/dashboard_hover_clone.png\" alt=\"\" width=\"2071\" height=\"1331\"><\/li>\n \t<li><strong>Enter the Source Book URL<\/strong> of the book you'd like to clone\n- or -\n<strong>Choose a book from the Pressbooks directory<\/strong> by entering a query in the '<strong>Search the Pressbooks Directory<\/strong>' field and clicking the '<strong>Select this book<\/strong>' button.<\/li>\n \t<li><strong>Enter the New Book URL<\/strong>. This will be the web address for the book you're about to create. It cannot be changed later, so choose carefully.\n<img class=\"alignnone wp-image-471 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2017\/08\/clone_interface.png\" alt=\"\" width=\"1782\" height=\"1350\"><\/li>\n \t<li><strong>Click Clone This Book<\/strong><\/li>\n \t<li>Watch the progress of the cloning operation. When the cloning process completes, <strong>click the new book's title in the success message<\/strong> to access the new book's admin dashboard.\n\n[caption id=\"attachment_162\" align=\"alignnone\" width=\"1029\"]<a href=\"http:\/\/eduguide.pressbooks.com\/wp-content\/uploads\/sites\/54880\/2017\/08\/Cloning-Step-6.jpeg\"><img class=\"size-full wp-image-161\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Cloning-Step-6.jpeg\" alt=\"\" width=\"1029\" height=\"100\"><\/a> Cloning success message[\/caption]<\/li>\n<\/ol>\n<h1>Understand Cloning Error Messages<\/h1>\nIf you attempt to clone a book which cannot be cloned, Pressbooks will display an error message which provides more information about why the cloning operation failed <em>before<\/em> beginning the cloning routine.\n<table style=\"border-collapse: collapse; width: 100%;\" border=\"0\">\n<tbody>\n<tr>\n<td style=\"width: 50%;\">\n\n[caption id=\"attachment_162\" align=\"alignnone\" width=\"305\"]<img class=\"wp-image-162 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screenshot-from-2021-08-02-09-05-48-e1634349048365.png\" alt=\"Clone a book error message\" width=\"305\" height=\"101\"> Error message shown when you attempt to clone a private book[\/caption]<\/td>\n<td style=\"width: 50%;\">\n\n[caption id=\"attachment_163\" align=\"alignnone\" width=\"327\"]<img class=\"wp-image-163 size-full\" style=\"color: #373d3f; font-weight: bold; font-size: 1em;\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screenshot-from-2021-10-15-18-54-18.png\" alt=\"Clone a book error message\" width=\"327\" height=\"55\"> Error message shown when you attempt to clone a book which is not licensed for cloning.[\/caption]<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"mceTemp\"><\/div>\n\n[caption id=\"attachment_167\" align=\"alignright\" width=\"163\"]<img class=\"wp-image-164 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screenshot-from-2021-10-15-20-48-09.png\" alt=\"\" width=\"163\" height=\"43\"> EventStream Connection Error[\/caption]\n\nIn some rare cases, an in progress cloning operation may display an 'EventStream Connection Error' message before the progress bar reaches 100%. This occurs most often when you are cloning very large books or attempting to clone from a self-hosted network with an overwhelmed server. Most of the time your cloning operation is still in progress and will complete successfully if you wait patiently. Instead of starting a new cloning operation for this book, we recommend waiting several minutes and then checking your 'My Books' listing in the top menu bar to see if your cloned book appears here. If the cloned book never appears, please contact your network manager.\n\n&nbsp;\n<h1><a id=\"whatcontentiscloned\" href=\"\"><\/a>What Content is Cloned<\/h1>\n<strong>What is included when you clone a book:<\/strong>\n<ul>\n \t<li>All the chapters, front matter, and back matter that were public and openly licensed in the original source book<\/li>\n \t<li>All the text in the above chapters, front matter, and back matter<\/li>\n \t<li>All the images, videos, and other media that were in the media library of the original source book and are linked from the cloned content<\/li>\n \t<li>Metadata associated with an image<\/li>\n \t<li>The metadata in the Book Info section of the original source book<\/li>\n \t<li>The metadata for the media content cloned from the original source book<\/li>\n \t<li>H5P activities that have been inserted into public parts, chapters, front matter or back matter.[footnote]All hosted Pressbooks networks fully support H5P cloning, but the success of the clone depends on the versions of Pressbooks and the H5P plugin running on both the source and target network. Open source networks must be running Pressbooks 5.13.0 or later and H5P 1.15.0 or later for H5P cloning to succeed. If you experience cloning errors related to H5P, please contact your network manager.[\/footnote]<\/li>\n<\/ul>\n<strong>What isn\u2019t included when you clone a book:<\/strong>\n<ul>\n \t<li>Chapters, front matter, and back matter in the source book that were not public (i.e. has 'show in web' checked) or openly licensed at the time the clone was performed<\/li>\n \t<li>TablePress tables<\/li>\n \t<li>Media galleries, audio and video playlists<\/li>\n \t<li>H5P activities that were created in the source book but have not been embedded in public parts, chapters, front matter, or back matter.<\/li>\n<\/ul>","rendered":"<p>Pressbooks enables you to easily &#8220;clone&#8221; or copy any public, openly licensed book from one Pressbooks network to another. When you clone a book to your own network, you create a copy of the original book. You can then revise, remix, and redistribute your copy however you like without affecting the original book.<\/p>\n<p>Book cloning enables a wide range of open pedagogical practices for both individuals and institutions. For example, cloning empowers students to collaborate on and improve &#8216;living resources&#8217; that have been sustained over several iterations of a course, allows teachers<span style=\"font-size: 1em;\"> to duplicate and immediately begin personalizing books specifically for their students&#8217; needs, enables <\/span><span style=\"font-size: 1em;\">course chairs or program leads to quickly update shared course material (like syllabi) each semester without altering or destroying previous versions, and lets u<\/span><span style=\"font-size: 1em;\">niversities freely share public teaching and research materials they have developed for quick adoption and adaptation by others.<\/span><\/p>\n<h1><a id=\"howtocloneabook\" href=\"\"><\/a>Clone a Book<\/h1>\n<p>You can clone any Pressbooks book that has been made public on the web and is in the public domain or has been published with a Creative Commons license that permits the free distribution of derivatives. Private books or books published as all rights reserved or &#8220;No Derivatives&#8221; licenses cannot be cloned.<br \/>\nTo clone a book:<\/p>\n<ol>\n<li>Click the &#8216;<strong>Adapt a book<\/strong>&#8216; button in the main panel of your user dashboard<br \/>\n&#8211; or &#8211;<br \/>\nClick the button &#8216;<strong>+ Clone Book<\/strong>&#8216; in the top menu from anywhere in Pressbooks to get to the Clone a Book interface. <img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-472 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2017\/08\/dashboard_hover_clone.png\" alt=\"\" width=\"2071\" height=\"1331\" \/><\/li>\n<li><strong>Enter the Source Book URL<\/strong> of the book you&#8217;d like to clone<br \/>\n&#8211; or &#8211;<br \/>\n<strong>Choose a book from the Pressbooks directory<\/strong> by entering a query in the &#8216;<strong>Search the Pressbooks Directory<\/strong>&#8216; field and clicking the &#8216;<strong>Select this book<\/strong>&#8216; button.<\/li>\n<li><strong>Enter the New Book URL<\/strong>. This will be the web address for the book you&#8217;re about to create. It cannot be changed later, so choose carefully.<br \/>\n<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-471 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2017\/08\/clone_interface.png\" alt=\"\" width=\"1782\" height=\"1350\" \/><\/li>\n<li><strong>Click Clone This Book<\/strong><\/li>\n<li>Watch the progress of the cloning operation. When the cloning process completes, <strong>click the new book&#8217;s title in the success message<\/strong> to access the new book&#8217;s admin dashboard.<br \/>\n<figure id=\"attachment_162\" aria-describedby=\"caption-attachment-162\" style=\"width: 1029px\" class=\"wp-caption alignnone\"><a href=\"http:\/\/eduguide.pressbooks.com\/wp-content\/uploads\/sites\/54880\/2017\/08\/Cloning-Step-6.jpeg\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-161\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Cloning-Step-6.jpeg\" alt=\"\" width=\"1029\" height=\"100\" \/><\/a><figcaption id=\"caption-attachment-162\" class=\"wp-caption-text\">Cloning success message<\/figcaption><\/figure>\n<\/li>\n<\/ol>\n<h1>Understand Cloning Error Messages<\/h1>\n<p>If you attempt to clone a book which cannot be cloned, Pressbooks will display an error message which provides more information about why the cloning operation failed <em>before<\/em> beginning the cloning routine.<\/p>\n<table style=\"border-collapse: collapse; width: 100%;\">\n<tbody>\n<tr>\n<td style=\"width: 50%;\">\n<figure id=\"attachment_162\" aria-describedby=\"caption-attachment-162\" style=\"width: 305px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-162 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screenshot-from-2021-08-02-09-05-48-e1634349048365.png\" alt=\"Clone a book error message\" width=\"305\" height=\"101\" \/><figcaption id=\"caption-attachment-162\" class=\"wp-caption-text\">Error message shown when you attempt to clone a private book<\/figcaption><\/figure>\n<\/td>\n<td style=\"width: 50%;\">\n<figure id=\"attachment_163\" aria-describedby=\"caption-attachment-163\" style=\"width: 327px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-163 size-full\" style=\"color: #373d3f; font-weight: bold; font-size: 1em;\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screenshot-from-2021-10-15-18-54-18.png\" alt=\"Clone a book error message\" width=\"327\" height=\"55\" \/><figcaption id=\"caption-attachment-163\" class=\"wp-caption-text\">Error message shown when you attempt to clone a book which is not licensed for cloning.<\/figcaption><\/figure>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"mceTemp\"><\/div>\n<figure id=\"attachment_167\" aria-describedby=\"caption-attachment-167\" style=\"width: 163px\" class=\"wp-caption alignright\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-164 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4748\/2022\/10\/Screenshot-from-2021-10-15-20-48-09.png\" alt=\"\" width=\"163\" height=\"43\" \/><figcaption id=\"caption-attachment-167\" class=\"wp-caption-text\">EventStream Connection Error<\/figcaption><\/figure>\n<p>In some rare cases, an in progress cloning operation may display an &#8216;EventStream Connection Error&#8217; message before the progress bar reaches 100%. This occurs most often when you are cloning very large books or attempting to clone from a self-hosted network with an overwhelmed server. Most of the time your cloning operation is still in progress and will complete successfully if you wait patiently. Instead of starting a new cloning operation for this book, we recommend waiting several minutes and then checking your &#8216;My Books&#8217; listing in the top menu bar to see if your cloned book appears here. If the cloned book never appears, please contact your network manager.<\/p>\n<p>&nbsp;<\/p>\n<h1><a id=\"whatcontentiscloned\" href=\"\"><\/a>What Content is Cloned<\/h1>\n<p><strong>What is included when you clone a book:<\/strong><\/p>\n<ul>\n<li>All the chapters, front matter, and back matter that were public and openly licensed in the original source book<\/li>\n<li>All the text in the above chapters, front matter, and back matter<\/li>\n<li>All the images, videos, and other media that were in the media library of the original source book and are linked from the cloned content<\/li>\n<li>Metadata associated with an image<\/li>\n<li>The metadata in the Book Info section of the original source book<\/li>\n<li>The metadata for the media content cloned from the original source book<\/li>\n<li>H5P activities that have been inserted into public parts, chapters, front matter or back matter.<a class=\"footnote\" title=\"All hosted Pressbooks networks fully support H5P cloning, but the success of the clone depends on the versions of Pressbooks and the H5P plugin running on both the source and target network. Open source networks must be running Pressbooks 5.13.0 or later and H5P 1.15.0 or later for H5P cloning to succeed. If you experience cloning errors related to H5P, please contact your network manager.\" id=\"return-footnote-60-1\" href=\"#footnote-60-1\" aria-label=\"Footnote 1\"><sup class=\"footnote\">[1]<\/sup><\/a><\/li>\n<\/ul>\n<p><strong>What isn\u2019t included when you clone a book:<\/strong><\/p>\n<ul>\n<li>Chapters, front matter, and back matter in the source book that were not public (i.e. has &#8216;show in web&#8217; checked) or openly licensed at the time the clone was performed<\/li>\n<li>TablePress tables<\/li>\n<li>Media galleries, audio and video playlists<\/li>\n<li>H5P activities that were created in the source book but have not been embedded in public parts, chapters, front matter, or back matter.<\/li>\n<\/ul>\n<hr class=\"before-footnotes clear\" \/><div class=\"footnotes\"><ol><li id=\"footnote-60-1\">All hosted Pressbooks networks fully support H5P cloning, but the success of the clone depends on the versions of Pressbooks and the H5P plugin running on both the source and target network. Open source networks must be running Pressbooks 5.13.0 or later and H5P 1.15.0 or later for H5P cloning to succeed. If you experience cloning errors related to H5P, please contact your network manager. <a href=\"#return-footnote-60-1\" class=\"return-footnote\" aria-label=\"Return to footnote 1\">&crarr;<\/a><\/li><\/ol><\/div>","protected":false},"author":2,"menu_order":5,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"chapter-type":[],"contributor":[],"license":[],"class_list":["post-60","chapter","type-chapter","status-publish","hentry"],"part":53,"_links":{"self":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapters\/60","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/wp\/v2\/users\/2"}],"version-history":[{"count":1,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapters\/60\/revisions"}],"predecessor-version":[{"id":61,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapters\/60\/revisions\/61"}],"part":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/parts\/53"}],"metadata":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapters\/60\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/wp\/v2\/media?parent=60"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/pressbooks\/v2\/chapter-type?post=60"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/wp\/v2\/contributor?post=60"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/pressbooks.palomar.edu\/guide\/wp-json\/wp\/v2\/license?post=60"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}