Story Map Journal - GitHub
文章推薦指數: 80 %
A Map Journal application can be created from ArcGIS Online, from the Esri Story Maps website or from an ArcGIS Enterprise portal. The Journal's data are stored ...
Skiptocontent
{{message}}
Esri
/
storymap-journal
Public
Notifications
Fork
77
Star
96
TheStoryMapJournalisidealwhenyouwanttocombinenarrativetextwithmapsandotherembeddedcontent.
License
Apache-2.0license
96
stars
77
forks
Star
Notifications
Code
Issues
35
Pullrequests
0
Actions
Projects
0
Wiki
Security
Insights
More
Code
Issues
Pullrequests
Actions
Projects
Wiki
Security
Insights
Esri/storymap-journal
Thiscommitdoesnotbelongtoanybranchonthisrepository,andmaybelongtoaforkoutsideoftherepository.
master
Branches
Tags
Couldnotloadbranches
Nothingtoshow
{{refName}}
default
Couldnotloadtags
Nothingtoshow
{{refName}}
default
2
branches
33
tags
Code
Clone
HTTPS
GitHubCLI
UseGitorcheckoutwithSVNusingthewebURL.
WorkfastwithourofficialCLI.
Learnmore.
OpenwithGitHubDesktop
DownloadZIP
LaunchingGitHubDesktop
Ifnothinghappens,downloadGitHubDesktopandtryagain.
LaunchingGitHubDesktop
Ifnothinghappens,downloadGitHubDesktopandtryagain.
LaunchingXcode
Ifnothinghappens,downloadXcodeandtryagain.
LaunchingVisualStudioCode
Yourcodespacewillopenonceready.
Therewasaproblempreparingyourcodespace,pleasetryagain.
Latestcommit
asizer
Readme,stillversion1.31.0,June2022release
…
2a51369
Jul11,2022
Readme,stillversion1.31.0,June2022release
2a51369
Gitstats
114
commits
Files
Permalink
Failedtoloadlatestcommitinformation.
Type
Name
Latestcommitmessage
Committime
src
.gitattributes
.gitignore
.jshintrc
CONTRIBUTING.md
Gruntfile.js
LICENSE.txt
README.md
map-journal-help-application-id.png
map-journal-storytelling-template-js.png
package.json
Viewcode
StoryMapJournal
Helpcontent
Introduction
Instructions
Feedback/support
FAQ
WhatshouldIcheckbeforepublishingaJournal?
Whatarethesupportedbrowsers?
Tipsforyourcontent
Linkbetweensections
Security
CanIkeepmyJournalprivate?
WhocaneditmyJournal?
CanIuseprivatewebmapsorlayers?
Deployment
CanIusethetemplatewithoutArcGISOnlineorArcGISEnterprise?
Whereisthedatastored?
CanIdeployMapJournalusingArcGISEnterprise?
Canthetemplatebeusedoffline?
CanIusethebuilderifIhosttheapponmyownwebserver?
HowdoIdeploytheapplicationonawebserver?
CanIuseasingledeploymentofMapJournalformultiplestories?
Configuration
Customizethelookandfeel
Customcolortheme
Othercustomization
UseanimageasthebackgroundoftheSideorFloatingpanelheader
Developerguide
Applicationlifecycle
Developerhelpers
Environmentsetup
Howtousetheapplicationfromthesourcecode
Howtobuildtheapplicationfromthesourcecode
Issuesbuildingtheapplication
Design
Issues
Contributing
Licensing
README.md
Note:ClassicEsriStoryMapstemplatesareinextendedsupportonArcGISOnlineasofSeptember2021andmaturesupportonArcGISEnterprise10.9.1.ForthelatestinformationonthetransitionfromclassicEsriStoryMapstoArcGISStoryMaps,clickhere.
StoryMapJournal
TheStoryMapJournalisidealwhenyouwanttocombinenarrativetextwithmapsandotherembeddedcontent.AMapJournalcontainsentries,orsections,thatuserssimplyscrollthrough.EachsectioninaMapJournalhasanassociatedmap,image,videoorwebpage.Actionscanalsobedefinedinjournalsectionssothat,forexample,clickingawordautomaticallyzoomsthesection’smaptoaparticularlocation.
Viewitlive|
MapJournalpageonEsriStoryMapswebsite|
Download
Thisreleaseisversion1.31.0,whichcorrespondstotheJune2022releaseofArcGISOnlineandthe11.0releaseofEnterprise.Ifyouwanttobeinformedofnewreleases,werecommendyoutowatchthisrepository(seeGitHubhelp).Seethereleasepageforreleasenotes.
FormoreinfomationaboutusingandcustomizingEsri'sStorytellingAppsfollowtheStoryMapsDevelopers'Corner.
Helpcontent
Introduction
Instructions
Feedback/support
FAQ
Configuration
Customizethelookandfeel
Developerguide
Issues
Contributing
Licensing
Introduction
AMapJournalapplicationcanbecreatedfromArcGISOnline,fromtheEsriStoryMapswebsiteorfromanArcGISEnterpriseportal.TheJournal'sdataarestoredinaWebApplicationItem.
ThisrepositoryprovidestheapplicationsourcecodefordeveloperswhowanttocustomizeMapJournal.
FormoreinformationaboutMapJournal,includingagalleryofexamplesandastep-by-steptutorial,pleaseseetheMapJournalpageontheEsriStoryMapswebsite.
Instructions
FirstcreateyourMapJournalinArcGISusingthestep-by-steptutorial.
Onceyourstoryisready,youhavetofinditsIDinArcGIS.TheIDisa32characterstringthatyouwillfindinyourwebbrowser'saddressbarwhenyouareviewingyourjournal.
Downloadtheapplication
Deploytheapplicationonyourwebserver.SeeFAQfordetails
Editindex.html,findtheconfigurationsectiononline38andpasteinyourapplicationID
Navigatetoindex.html(e.g.,http://127.0.0.1/MapJournal/index.html)
YoucancontinuetousethebuilderinArcGIStomodifyyourstory.
Seecustomizethelookandfeelsectionordeveloperguideifyouwanttomodifytheapp.
IfyouareusingArcGISEnterprise,pleasefollowtheinstructionsattheendofapp/config.jstoconfiguretheapplication.OptionallyyoucanalsoconfiguretheapplicationtousetheArcGISAPIforJavaScriptincludedinyourEnterpriseportal.
Feedback/support
Wewouldlovetohearfromyou!
StoryMapsWebsite
Letusknowaboutyourapplication
StoryMapsforumonGeoNet
@EsriStoryMaps
ArcGISBlog
Whenyoucontactus,don'thesitatetoincludealinktoyourapplicationtomakeiteasierforustounderstandwhatyouareworkingon.
FAQ
WhatshouldIcheckbeforepublishingaJournal?
WerecommendthatyouperformthefollowingchecksbeforesharingyourJournalwithyouraudience:
CheckthatallyourJournal'scontentissharedwithyouraudience(webmaps,medias,...).Typicallyyoucanuseanothercomputerthantheoneyouhaveusedtobuildyourstorytomakesureeverythingisloadingproperly.Alternativelythisarticlewillshowyouhowtoconfigureyourbrowserforanincognitosessionoryoucanjustsign-outfromArcGISandanyservicethatyouhaveusedtohostyourJournal'sresources.
Trytheapplicationondifferentbrowsers,screenresolutionsandmobiledevices.Youcanemulatemobiledevicesinsideyourdesktopbrowser.
Whatarethesupportedbrowsers?
MapJournalissupportedonInternetExplorer11andabove,Chrome,Firefox,Safari,andthemostrecenttabletandsmartphonedevices.
MapJournalauthoringissupportedonthesamedesktopbrowserslistedaboveandonthemostrecenttabletbutnotsmartphonedevices.
Weactivelytesttheapplicationinallmajorbrowsersbutifyouexperiencedifficultiesespeciallywiththebuilder,werecommendthatyouuseChrome.
Tipsforyourcontent
Linkbetweensections
OnepopularrequestistoaddtheabilitytonavigatebetweenaJournal'ssectionsusinglinksinthepanelorthroughmapfeaturespopup.AsofSeptember2016,thisabilityisnowavailableinthebuilder.
Toaddalinktoanothersectioninthenarrativepanel,highlightthetextforwhichyouwanttocreatethelinkandusetheNaviagetoasectionactioninthetoolbar.Seethisblogformoreinformation.
Youcanalsoaddthiscapabilitytomapfeaturepopups.Thiscan,forexample,allowthehomesectionmaptobethespatialindextoyourstory.Todothatyouneedtodownloadtheapplicationandincludeapieceofcodeinapp/custom-scripts.js.Modifythatfileasshownbelow.Followtheinstructionstoconfigurethewebmapandthelayerthatwillreceivetheclickevent.
define(["dojo/topic"],function(topic){
/*
*CustomJavascripttobeexecutedwhiletheapplicationisinitializinggoeshere
*/
//Theapplicationisready
topic.subscribe("tpl-ready",function(){
/*
*CustomJavascripttobeexecutedwhentheapplicationisreadygoeshere
*/
});
/*
*Setupaclickhandleronthefeatureofthemaptonavigatethestory
*/
//
//*************************************
//Configurethewebmapidandlayerid
//*************************************
//
//FirstfindthewebmapidthroughtheURLwhenyouopenthemapinMapViewer
//Togetthelayerid,pastethewebmapidbelowandopentheapplication,
//thenopenthedeveloperconsole,allthelayersidswillbelisted,
//findthecorrectoneandpasteitbelow
//Afterthissetup,clickingthe3rdfeatureofyourlayer,willnavigatetothethirdentry
//
varWEBMAP_ID="0bb11c0469f042b3afaf8b0d76572822",
LAYER_ID="csv_7673_0";
varclickHandlerIsSetup=false;
topic.subscribe("story-loaded-map",function(result){
if(result.id==WEBMAP_ID&&!clickHandlerIsSetup){
varmap=app.maps[result.id].response.map,
layer=map.getLayer(LAYER_ID);
console.log(map.graphicsLayerIds);
if(layer){
layer.on("mouse-over",function(e){
map.setMapCursor("pointer");
map.infoWindow.setContent(""+e.graphic.attributes.name.split(",")[0]+"
Clicktozoom");
map.infoWindow.show(e.graphic.geometry);
});
layer.on("mouse-out",function(e){
map.setMapCursor("default");
map.infoWindow.hide();
});
layer.on("click",function(e){
varindex=e.graphic.attributes["__OBJECTID"];
topic.publish("story-navigate-section",index);
});
}
clickHandlerIsSetup=true;
}
});
});
Security
CanIkeepmyJournalprivate?
Yes,theregularArcGISsecuritymodelapplies.
BydefaultyourJournalisprivate,youcanshareitthroughMapJournalbuilderorArcGIS.
WhenyoushareyourJournal,itisyourresponsibilitytomakesurethatalltheresourcesofyourJournal(webmaps,images,videos)areaccessibletoyouraudience.
WhocaneditmyJournal?
AJournalcanbeeditedbyitsowner(thenamedaccountthatinitiallycreatedtheJournal),amemberintheAdministratorrole(doesnotapplyforpublicaccount),oramemberwiththeadministrativeContent>Updateprivilege.Youcanalsouseagroupwithupdatecapabilitiestocollaborateonastorymap.SeethisFAQformoreinformation.
CanIuseprivatewebmapsorlayers?
Yes.
WhentheJournalishostedinArcGISOnlineorArcGISEnterprise,userswhodon'thaveaccesstotheJournalorawebmapusedintheJournalwillberedirectedtotheArcGISsign-inpage.ItisnotpossibletodisplayanauthenticationdialogintheMapJournalwhentheJournalishostedinArcGIS.
WhentheJournalishostedonyourwebserver,anauthenticationdialogwillappearinsidetheapplication.
Notethatforthatauthenticationtoworkonsomeolderbrowser(InternetExplorer9)youneedtoinstallaproxyserveronyourwebservertomakesurethelogincredentialscanbepassedsecurelytoArcGISOnline.Formoreinformation,seetheUsingtheproxyintheArcGISAPIforJavaScriptdocumentation.
Becauseofthatlimitation,werecommendthatyouconfiguretheapplicationtouseOAuth.OAuth2.0basedauthenticationisavailableforArcGISOnlineuserswithdeveloperororganizationalaccountsandArcGISEnterpriseusers.FollowtheproceduretoaddanapplicationandregisteranapplicationtogetanOAuthapplicationID.Onceyouhavethatapplication,openindex.html,locatetheconfigOptionssectionandfilltheoAuthAppIdproperty.
Ifyouareusingsecuredservicesbutdon'twantuserstohavetoauthenticate,youcanuseaproxytostoretheusername/passwordtobeused.SeeWorkingwithProxyServices,andaddproxyrulestospecifywhatservicesneedtousetheproxybyeditingPROXY_RULESinapp/config.js.
Deployment
DeployingaMapJournalrequiresuseofArcGISOnlineorArcGISEnterprise.TheJournalcontentmustbecreatedusingtheMapJournalbuilderandwillliveinaWebApplicationItem.
CanIusethetemplatewithoutArcGISOnlineorArcGISEnterprise?
Thisisnotasupportedusecaseatthistime.Pleaseletusknowifyouareinterestedinsuchascenario.
Whereisthedatastored?
TheJournal'sdataarestoredinaWebApplicationIteminArcGISOnlineoranArcGISEnterpriseportal.Thisincludesthenarrativecontent,referencetoanymediaused(webmaps,pictures,videos,webpages),andapp-widesettings.
TheimagesandvideosthatyouincludeinyourJournalusingthebuilderarenotcopiedintoArcGISunlessyouuploadthemthroughthe"Upload"option.Youhavetomakesurethatanyexternalmediaandwebmapsyouareusingare,andwillremain,accessibletoyouraudience.
CanIdeployMapJournalusingArcGISEnterprise?
Yes,MapJournalisincludedwithPortalforArcGIS10.3uptothecurrentversionofArcGISEnterprise.
IfyouareusingPortalforArcGIS10.3orlaterandwanttoupdateMapJournal,downloadthelatestversion.IfyouareusingPortal10.2.1or10.2.2,youcan'tdeploythelatestversionofMapJournalandhavetodeploythefollowingversionMapJournalV1.0.2-portal.
Then:
FindyourPortalapps/MapJournalfolder(dependingonyourinstallationandversionofPortal,thisiseitherC:\ProgramFiles\ArcGIS\Portal\apps\MapSeriesorC:\ProgramFiles\ArcGIS\Portal\webapps\arcgis#home\webmap\templates\MapJournal).
Removethecontentofthatfolder
Extractthearchivesothatindex.htmlislocatedatMapJournal\index.html
IfMapJournalwasalreadyincludedinyourportal,youaredone(PortalforArcGIS10.3+).
IfMapJournalwasnotavailableinyourportal:
LogintoPortalforArcGISandopenMyContent>AddItem>Application>WebMappingApplication>Configurable.ConfiguretheURLtohttps://portal.domain.com/arcgis/apps/MapJournal.Moredetailsinthefollowingdocumentationpublishinganewwebapplicationitem.
CreateanewgroupthatwillreferencethetemplateavailableinyourPortal
Sharethenewlycreateditemwiththatgroup
OpenMyOrganization>EditSettings>MapandsettheWebAppTemplatestothenewlycreatedgroup.Moredetailsinthefollowingdocumentationconfiguringthewebapplicationgallery
Nowwhenyoushareawebmap,thetemplateshouldbeanoption
NotethatthearchiveyoudownloadedisusingtheArcGISAPIforJavaScripthostedinArcGISOnline.ThiscancreatesomeincompatibilitywithyourArcGISEnterpriseinstallation.Ifyourunintoissue,pleaseseethenextsectiontoupdateit.
AlsonotethatthewebapplicationgallerypreviewfeatureredirectstotheStoryMapswebsite.Thetargetpagecanbemodifiedinapp/config.js>HELP_URL_PORTAL.
Canthetemplatebeusedoffline?
Yes,byusingArcGISEnterpriseandconfiguringthetemplatetousetheArcGISAPIforJavascriptincludedwiththeEnterpriseportal.
ToedittheArcGISAPIforJavaScript,editindex.htmlandlocatepathJSAPIaroundline69.TheURLis//webadaptor.domain.com/arcgis/jsapi/jsapiwherearcgisisthenameofyourWebAdaptor.
WhendeployedonanArcGISEnterpriseportal,theapplicationdoesn'trequireanyexternalservicestofunction.But,bydefault,thetemplatewillstillincludetheheadersocialbuttons(Twitter,Facebook),andJournalauthorsareabletoimportpicturesandvideosfromonlinehostingservices.Theseoptionscanbedisabledindividuallythroughtheconfigurationfileapp/config.js.
CanIusethebuilderifIhosttheapponmyownwebserver?
Yes,whenthetemplateisconfiguredwithanapplicationID,addingtheURLparameter'edit'willopenthebuilder.YouwillbepromptedforuserauthenticationthroughtheIdentityManager.
HowdoIdeploytheapplicationonawebserver?
Ifyouarenotfamiliarwithwebservers,herearetwosolutions:
UsethewebserverthatcomeswithyourserverOperatingSystem.OnWindowsthisisInternetInformationServices(IIS);ifyouhaveaC:\inetpub\wwwrootfolderonyourcomputer,youshouldbeabletoaccessit'scontentusinghttp://localhost
OnWindowsorMacOS,useasimplewebserverlikeMongoose(notrecommendedforproduction)
Ifyouareexperiencingsomerenderingissueslikeimpropersymbolappearinginsteadoficons,youwillhaveextraconfigurationtoperform.SomeserversrequiretheconfigurationofanewmimetypetobeabletoserveMapJournalfontscorrectly.Seethefollowinglinksformoreinformation:
IISMimetypes
Properlyservewebfonts
CanIuseasingledeploymentofMapJournalformultiplestories?
Yes.
Ifyouhavecustomizedtheapplicationanddeployeditonyourserver,youdon'tneedtocopyitmultipletimes,editindex.htmlandpasteadifferentapplicationIDforeachstoryyouwanttopublish.
Insteadeditindex.html,locatetheconfigOptionssectionandfilltheauthorizedOwnerspropertywiththeArcGISOnlineorArcGISEnterpriseportalloginoftheowner(s)oftheJournalsyouwanttouse.ThismakesitpossiblefortheapplicationtodisplayanyoftheJournalscreatedbythespecifieduser(s)throughanURLparameter.
Exampleofthesameapplicationdisplayingtwostories:
http://myserver.com/MapJournal/index.html?appid=c7ad1a55de0247a68454a76f251225a4
http://myserver.com/MapJournal/index.html?appid=c7ad1a55de0247a68454a76f251225a5
Configuration
Inadditiontotheconfigurationofferedbythebuilder,thefileapp/config.jsprovidesvariousadditionalsettings.ThisisforexampletheplacewhereyoucanoverridesomesettingslikethelistofGeocoderservicestobeused(changesoverrideArcGISOnlineoryourOrganizationdefaultsettings).Seethedocumentationprovidedinthatfileformoredetails.
Customizethelookandfeel
Customcolortheme
AsMapJournaldoesn'tyetoffertheabilitytocreateacustomthemethroughthebuilder,customizingthevariouscolorsoftheapplicationrequireschangingthedataofyourapp.Seeourblogpostaboutcustomizingthemecolors.
Youcouldalsodownloadandconfigurecolorsthroughapp/config.js.ForexampleifyouareusingaSidePanellayoutandhavekeptthedefaulttheme,openapp/config.js,locatetheLAYOUTpropertyandeditthefollowinglinewiththedesiredcolors.
themes:[
{name:"side-default-1",dotNav:"#777777",panel:"#FFFFFF",media:"#EEEEEE",text:"#000000",textLink:"#555",esriLogo:"black"},
...
]
Othercustomization
MostofthelookandfeelcustomizationcanbedoneusingtheregularApplicationDownloadandincludingthecss/htmloverridesdirectlyintoindex.html.
AstheapplicationJavascriptandCSSareminified,wedon'trecommendthatyoudirectelyeditthosefiles(e.g.app-viewer-min.css,app-viewer-min.js,...).Inadditiontobeinghardtoedit,thiswillmakeapplicationupdatescomplexforyou.
Ifyouwanttochangethebehaviorofonefunctionalityorwanttoaddanewone,followthedeveloperguidebelow.
TheeasiestwaytofindtheIDorpathofaDOMelementthatyouwanttocustomizeistouseyourbrowser'sdevelopertools--readthedocumentationforChrome,Safari,Firefox.
Hereisacustomizationexamplethatcanachievedthroughthestyletagalreadypresentforyouinindex.html(searchfor/*CUSTOMCSSRULES*/):
UseanimageasthebackgroundoftheSideorFloatingpanelheader
...
延伸文章資訊
- 1Esri Story Map Journal - Create a Rich Multimedia Narrative
The Esri Story Map Journal app template is ideal when you want to combine in-depth narrative text...
- 2Story Map Journal
Presents map-based narrative as a set of multimedia journal entries. ... A Story Map Journal can ...
- 3Story Map Journal 教學
Story Map Journal℠. 這項App 會建立地點導覽序列,並讓您創作精彩內容,呈現引人入勝的地圖故事。對於結合文字、地圖、相片和影片的多媒體故事,使用本項App 進行呈現 ...
- 4ArcGIS Story Map Journal Tutorial (final)-1
Before you start. ▫ In this tutorial you'll use our interactive Story Map Journal℠ Builder to aut...
- 5Telling Your Story with Esri Story Maps: A New Medium for ...
Building a story map journal. 8. Building a side accordion story map ... Story Maps incorporate b...