Index: chrome/common/extensions/docs/templates/intros/mediaGalleries.html |
diff --git a/chrome/common/extensions/docs/templates/intros/mediaGalleries.html b/chrome/common/extensions/docs/templates/intros/mediaGalleries.html |
index d5729eac83a498d9264d65b081d866eb2cbbcc6a..194ac22d03db25399d4b4171ee38394e59def141 100644 |
--- a/chrome/common/extensions/docs/templates/intros/mediaGalleries.html |
+++ b/chrome/common/extensions/docs/templates/intros/mediaGalleries.html |
@@ -110,21 +110,42 @@ to read all the media files from galleries that the user selected.</p> |
<p>If present, the user's iTunes library can be accessed as a media gallery. |
In addition to the media files in the library, the "iTunes Music Library.xml" |
-file is also presented. Regardless of where the music files are actually on the |
-disk (and where the xml file says they are), they are mapping into an |
-Artist/Album/Track hierarchy like iTunes does by default. This mapping doesn't |
-always work perfectly, so there are two things to note for Apps trying to match |
-the xml file with files in the gallery. If the filenames for tracks within an |
-album are not unique, they will be uniquified by adding the track id in |
-parentheses before the extension, and if there is a colon or a slash in the |
-artist, album, or track name, they are turned into underscore characters.</p> |
+file is also presented.</p> |
+<p>Regardless of where the music files are actually on the disk (and where |
+the xml file says they are), they are mapped into an Artist/Album/Track |
+hierarchy like iTunes does by default. This mapping doesn't always work |
+perfectly, so there are two things to note for Apps trying to match the |
+xml file with files in the gallery.</p> |
+<p>If the filenames for tracks within an album are not unique, they will be |
+uniquified by adding the track id in parentheses before the extension, and |
+if there is a colon or a slash in the artist, album, or track name, they are |
+turned into underscore characters.</p> |
<h2 id="Picasa">Picasa</h2> |
<p>If present, the user's Picasa library can also be accessed as a media |
gallery. Directories on the filesystem scanned by Picasa are presented under |
-folders/. Picasa Albums are presented under albums/. Albums and Folders that |
-have duplicate names and dates will be uniquified using an incrementing |
-integer in parenthesis before the extension. Duplicate filenames within the |
-same Album will also be uniquified using an incrementing integer in parenthesis |
-before the extension.</p> |
+folders/. Picasa Albums are presented under albums/.</p> |
+<p>Albums and Folders that have duplicate names and dates will be uniquified |
+using an incrementing integer in parenthesis before the extension.</p> |
+<p>Duplicate filenames within the same Album will also be uniquified using an |
+incrementing integer in parenthesis before the extension.</p> |
+ |
+<h2 id="iPhoto">iPhoto</h2> |
+ |
+<p>If present, the user's iPhoto library can be accessed as a media gallery. |
+The files are structured within a subdirectory called "Albums/". Within that |
+subdirectory, each album in the user's iPhoto library will appear as a |
+subdirectory by name, and contain file entries for the photos in that album. |
+</p> |
+<p>Duplicate album names or image filenames with albums will get a |
vandebo (ex-Chrome)
2014/03/28 20:52:46
with -> within ?
|
+disambiguating suffix like "(NN)" where NN is a unique number.</p> |
+<p>Any items appearing in multiple albums in iPhoto will appear in all those |
+albums in the gallery.</p> |
+<p>If the user has modified any images within an album, there will be an |
+additional subdirectory called "originals/" within the album directory, which |
+will then contain the original image, which will have the same filename as |
+the file in the album itself. The file as it appears in the album directory, |
+though, will be the one the user has invested time cropping, rotating, or |
+otherwise editing.</p> |
+ |