{"id":60,"date":"2017-08-24T19:21:13","date_gmt":"2017-08-24T19:21:13","guid":{"rendered":"https:\/\/openbook.ums.edu.my\/userguide\/chapter\/clone-a-book\/"},"modified":"2024-09-19T04:19:23","modified_gmt":"2024-09-19T04:19:23","slug":"clone-a-book","status":"publish","type":"chapter","link":"https:\/\/openbook.ums.edu.my\/userguide\/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 to duplicate and immediately begin personalizing books specifically for their students' needs, enables <\/span>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>niversities freely share public teaching and research materials they have developed for quick adoption and adaptation by others.<\/span>\n\nhttps:\/\/www.youtube.com\/watch?v=pvSpZ_lgRQk\n

<\/a>Clone a Book<\/h1>\n \n\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\u00a0a Creative Commons license that permits the free distribution of derivatives.\u00a0Private books or books pubished as all rights reserved or \"No Derivatives\" licenses cannot be cloned.\n \n\nTo clone a book:\n
    \n \t
  1. \"\"Click 'My Catalog -> Clone a Book<\/strong>' from the top nav-bar or click the 'Clone a Book' button on your user dashboard to be brought to the Clone A Book interface<\/li>\n \t
  2. Enter the Source Book URL<\/strong> of the book you'd like to clone<\/li>\n \t
  3. Enter the Target 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.<\/li>\n \t
  4. Enter your desired Target Book Title<\/strong>. If you leave this field blank, the target book will have the same title as the source book. Your book title can be changed after cloning is completed using the Book Info<\/a> tool.\n\"\"<\/li>\n \t
  5. Click Clone This Book<\/strong><\/li>\n \t
  6. Watch the progress of the cloning operation. When the cloning process completes, 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> Cloning success message[\/caption]<\/li>\n<\/ol>\n

    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 before<\/em> beginning the cloning routine.\n\n\n\n
    \n\n[caption id=\"attachment_162\" align=\"alignnone\" width=\"305\"]\"Clone Error message shown when you attempt to clone a private book[\/caption]<\/td>\n\n\n[caption id=\"attachment_163\" align=\"alignnone\" width=\"327\"]\"Clone 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>\n\n[caption id=\"attachment_167\" align=\"alignright\" width=\"163\"]\"\" 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 nav-bar to see if your cloned book appears here. If the cloned book never appears, please contact your network manager.\n\n \n

    <\/a>What Content is Cloned<\/h1>\nWhat is included when you clone a book:<\/strong>\n
      \n \t
    • All the chapters, front matter, and back matter that were public and openly licensed in the original source book<\/li>\n \t
    • All the text in the above chapters, front matter, and back matter<\/li>\n \t
    • 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
    • Metadata associated with an image<\/li>\n \t
    • The metadata in the Book Info section of the original source book<\/li>\n \t
    • The metadata for the media content cloned from the original source book<\/li>\n \t
    • 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>\nWhat isn\u2019t included when you clone a book:<\/strong>\n
        \n \t
      • 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
      • TablePress tables<\/li>\n \t
      • Media galleries, audio and video playlists<\/li>\n \t
      • 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

        Enable Source Comparison in a Cloned Book<\/h1>\nYou can enable source comparison on a cloned book to allow readers to view the difference between your cloned book and the source material it was cloned from.\u00a0To enable source comparison on a cloned book:\n
          \n \t
        1. Click 'Appearance -><\/strong>\u00a0Theme Options<\/strong>'<\/li>\n \t
        2. Click the Web Options\u00a0<\/strong>tab<\/li>\n \t
        3. Click the <\/strong>'Enable Source Comparison' checkbox <\/strong>to \"Add comparison tool to the end of each front matter, part, chapter, and back matter\"\n\"\"<\/li>\n \t
        4. Click\u00a0Save Changes\u00a0<\/strong><\/li>\n<\/ol>\n

          View Source Comparison for a Cloned Book<\/h1>\nAfter you've enabled source comparison on a cloned book, a SHOW COMPARISON WITH ORIGINAL\u00a0<\/strong>button will be added to the bottom of the reading interface in every chapter of your book.\n\"\"\n\nClicking this button will cause the source comparison to be displayed if it currently invisible, or hidden if it is currently visible. When expanded the Show Comparison view will indicate the total number of additions and deletions, following by two columns of HTML output.\n\n\"\"\n\nThe source book text will appear in the left column and the clone book text will appear on the right. Differences will be highlighted; modified sections are set in red in the source text and green in the cloned text. Deletions will appear in a bolder red in the source book column; additions will appear in bolder green in the cloned text column.\n\n\"Source\n\n ","rendered":"

          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.<\/p>\n

          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 ‘living resources’ that have been sustained over several iterations of a course, allows teachers to duplicate and immediately begin personalizing books specifically for their students’ needs, enables <\/span>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>niversities freely share public teaching and research materials they have developed for quick adoption and adaptation by others.<\/span><\/p>\n