Remixing: Difference between revisions

From Proteopedia
Jump to navigationJump to search
Karsten Theis (talk | contribs)
No edit summary
Jaime Prilusky (talk | contribs)
No edit summary
Line 17: Line 17:
== Remixing 3D scenes from Proteopedia ==
== Remixing 3D scenes from Proteopedia ==


=== Finding the script ===
=== Finding the scene block ===
Let's say you want to reuse a 3D scene you found on an existing Proteopedia page. To remix the 3D scene, you need the scene block for the scene, that looks like this <span style='background-color:#cecece;'>&lt;scene name='77/778334/A_chain/1'>green link text&lt;/scene></span>. Go into the edit tab of the source page and look for the 'scene' tags.


Let's say you want to reuse a 3D scene you found on an existing Proteopedia page. To remix the 3D scene, you need to know the name of the underlying state script. Again you can go into the edit tab of your source page, and look for 'scene' tags. They will contain the path to the script (in a format like '77/778334/A_chain/1', giving a pair of internal numbers, the scene name and version number).
=== Using the scene as is ===
If you don't want to modify the scene at all (no new caption, no new orientation, no new transition options), paste the scene block into your page and save. The new scene should be working. It's ok to modify the green link text.


If you are looking at the scene already, you can also get the script from the Jmol console (this way, you can make sure you have the correct scene):
=== Modifying the scene on SAT ===
#. Click on the green link
To modify other page's scene and save it as a new local scene: Add first the scene block to your page, as described above, and save your page. Open again your own page for editing. SAT will offer now for loading, in the [load scene] tab, all the scenes found on your own page, and on all the pages from where you are reusing scenes. You may now edit any of the available scenes, changing caption, loading mode, representation, etc. SAT will save the resulting scene as local, under your own page area. You may now remove the scene block from the source page.
#. Right click in the Jmol window
#. Open a Jmol console if it is not open already
#. Show the history
#. Go from the bottom of the history to the closest line (often 4 lines up, above "set refreshing true") that contains a script (URL contains "/wiki/scripts"). Note down the name and number of the script, along with the name of the page.


These steps are shown graphically in this [http://proteopedia.org/wiki/index.php/Image:Remix_steps.jpg diagram]. At this point, you should add the URL of the scene to your Content Donor section. You should attribute the page (there is no obligation to find the specific author among the source page's multiple authors).
=== Modifying scenes created before 2013 ===
Scenes created before 2013 used a scene block like this <span style='background-color:#cecece;'>&lt;scene name='Green_Fluorescent_Protein/Chromophore/1'></span>.  


=== Loading the script into the SAT ===
To use the scene as is, just proceed as described before: paste the scene block on your page, modify the green link if desired and save.


Then, go to the scene authoring tool (SAT) of your new page, and load the scene (by entering the source page name, and selecting scene and version number). Modify it if you need, add a caption, and save it under a name that makes sense in the new context. Some scenes do not appear in the SAT under the page name you expect. If you get stuck, look at the source of the script (e.g. 77/778334/A_chain/1 is at proteopedia.org/wiki/scripts/77/778334/A_chain/1.spt). On the line that starts with "# documentBase", you will find the page where the script originated after the string "title=". Using this page name in the SAT, you should be able to load the scene, modify it, and save it for your new page.
To modify one of these scenes you'll need to load the scene on SAT as follows:
 
# Edit your page and expand SAT
=== Using the scene as is ===
# Open JSmol Console with the button under the applet
If you don't want to modify the scene at all (no new caption, no new orientation, no new transition options), you could also add it by pasting a scene block directly into the text, e.g.  <pre><scene name='77/778334/A_chain/1'>green link text</scene></pre> The disadvantage is that it becomes harder to remix for others, who have to do some extra steps (described in the section above) to find the originating page.
# build the path to the scene as follows, replacing Green_Flu... by the scene info you retrieved from the scene block of the scene you want to work with: <span style='background-color:#cecece;'>'/wiki/scripts/Green_Fluorescent_Protein/Chromophore/1.spt'</span>
# paste into the lower portion of the JSmol Console a line like this <span style='background-color:#cecece;'>script pathToTheScene;</span> and click [Run]
# modifify the scene on SAT, if desired
# save the scene on the [save scene] tab, as a new scene local to your page.  


== Remixing scenes from Proteopedia as images ==
== Remixing scenes from Proteopedia as images ==