[ Pobierz całość w formacie PDF ]
.1.Utwórz w folderze Shared folder, w którym będzie przechowywana dokumentacja.Niech ten nowy folder nazywa się Development.Rysunek 22.28 prezentuje aktualnąstrukturę folderów.Rys.22.28.Struktura folderaConfiguration/Shared,który zawiera nowyfolder Development2.Utwórz plik HTML.Strona pomocy powinna zawierać informacje na temat funkcjibehawiora, pól i przyjmowanych przez nie danych oraz wszelkie inne informacje, któreuznasz za przydatne dla użytkowników.Możesz utworzyć nowy plik lub skorzystać zpliku ResizeWindowHelp.html, zapisanego na płycie CD.Rysunek 22.29 prezentujewygląd typowego pliku pomocy.Zapisz plik w folderzeConfiguration/Shared/Development, pod nazwą ResizeWindowHelp.html.3.Dodaj do okna dialogowego behawiora przycisk wywoływania pomocy.Otwórz plikbehawiora ResizeWindow.js w edytorze tekstu.Umieść w kodzie definicję funkcji:function diplayHelp() {}Funkcja ta jest częścią Dreamweaver API.Będzie więc wywoływana automatycznie.Gdyto zrobisz, załaduj ponownie rozszerzenia i wypróbuj działanie poprawionego behawiora.Gdy pojawi się okno dialogowe, powinien w nim być wyświetlany przycisk Help, tak jakna rysunku 22.27.Ponieważ nie została jeszcze wpisana treść funkcji, kliknięcie tegoprzycisku nigdzie nie prowadzi.Rys.22.29. Plik pomocybehawiora ResizeWindow w oknieprzeglądarki4.Przekształć przycisk pomocy w połączenie do pliku pomocy.Jest to standardowaprocedura, a skorzystasz w niej z funkcji stanowiącej element Dreamweaver API dw.browseDocument().Jako swój argument, funkcja przyjmuje bezwzględny adresURL.Jeśli plik pomocy jest umieszczony w sieci na przykład na serwerze witrynyTwojej firmy, aby użytkownicy mieli zawsze dostęp do najświeższych i najwspanialszychplików pomocy jako argument funkcji wpisz po prostu pełną ścieżkę dostępu do niego(bezwzględny adres URL).W tym przypadku funkcja będzie więc wyglądać tak:function displayHelp() {dw.browseDocument(http://www.mojafirma.com/dwHelpFiles/ResizeWindow.html);}Ponieważ plik pomocy będzie ściągany na dysk twardy użytkownika, kod musi zwracaćbezwzględną ścieżkę dostępu do tego pliku.Całe szczęście, funkcja Dreamweaver API,dw.getConfigurationPath(), zwraca adres bezwzględny foldera Configuration.Pozostaje więc jedynie określić na podstawie tych informacji ścieżkę dostępu do plikuwzględem tego foldera nadrzędnego i połączyć te dwie rzeczy razem.Tak więc kod, którypowinieneś wprowadzić, powinien wyglądać tak:function displayHelp() {var myURL = dw.getConfigurationPath();myURL += /Shared/Development/ResizeWindowHelp.html ;dw.browseDocument(myURL);}Wprowadz ten kod.Następnie załaduj ponownie rozszerzenia i wypróbuj behawior.Jeśliprawidłowa strona pomocy nie pojawi się, sprawdzaj i testuj kod, aż wszystko będzie wporządku.Sprawdz, czy prawidłowo podałeś ścieżkę dostępu z foldera Configurationdo pliku pomocy w zależności od stosowanych przez Ciebie nazw plików i folderów, wTwoim przypadku ścieżka dostępu może wyglądać inaczej, niż w tym ćwiczeniu.Początek ramkiUwagaObie zaprezentowane tu funkcje API są w rzeczywistości metodami obiektu Dreamweaver.Metody tego obiektu można zapisać jako dreamweaver.nazwaFunkcji() lubdw.nazwaFunkcji().W drugim przypadku prawdopodobieństwo pomyłki literowej jestmniejsze.Koniec ramki RozprowadzanieW jaki sposób zamierzasz umieścić swój śliczny obiekt lub behawior we folderachConfiguration użytkowników programu Dreamweaver? Przeczytaj instrukcje.Przygotowanie pakietu przy pomocy menedżera rozszerzeńExtension Manager staje się standardowym narzędziem bezbolesnej instalacji rozszerzeń.Z tegowzględu stanowi on najprostszą drogę współdzielenia rozszerzeń.Całe szczęście, menedżer rozszerzeń nie tylko instaluje rozszerzenia, lecz także archiwizuje je dopostaci specjalnych plików instalacyjnych.Proces ten jest w zasadzie bezbolesny.Oto jego etapy:1.Umieść wszystkie niezbędne pliki (pliki pomocy, HTML i JS oraz ikony GIF) w jednymfolderze, zlokalizowanym poza folderem Configuration.2.Utwórz plik instalacyjny.Jest to dokument XML, o rozszerzeniu nazwy.mxi, któryzawiera wszystkie instrukcje potrzebne przy instalacji.Są to informacje na temat miejscaskładowania plików, wersji Dreamweavera i rodzaju platform wymaganych przeszrozszerzenie, autora, typu rozszerzenia oraz jego opis.Wymagania dotycząceformatowania są bardzo rygorystyczne.Początkujący powinni skorzystać z przykładówudostępnianych przez menedżera rozszerzeń.Znajdziesz wśród nich plik blank.mxi jest to pusty dokument, który może być stosowany jako szablon, oraz plik sample.mxi,zawierający wymagany zestaw informacji dla prostego obiektu.3.Uruchom menedżera rozszerzeń i wybierz polecenie Package Extension z menu File.Na rysunku 22.30 zaprezentowany został przykładowy folder zawierający wszystkie pliki,niezbędne do utworzenia wersji zarchiwizowanej obiektu.Procedura tworzenia foldera jestopisana w ostatnim z ćwiczeń tego rozdziału.Rys.22.30.Wszystkieskładowe obiektuContact Info,gotowe doarchiwizacjiwiczenie 22.15.Archiwizacja rozszerzeniaW tym ćwiczeniu zarchiwizujesz obiekt Contact Info, aby umożliwić udostępnienie go innym.1.Skopiuj wszystkie potrzebne pliki do jednego foldera.Utwórz na swoim dysku twardymnowy folder, lokalizując go poza folderem Configuration.Nadaj mu dowolną nazwę,którą zapamiętasz (na przykład Contact Info).Odszukaj wszystkie pliki składowebehawiora i skopiuj je do tego foldera.Ich lista podana jest poniżej:Contact Info.htmlContact Info.jsContact Info.gif 2.Otwórz pusty plik blank.mxi, który posłuży do utworzenia pliku instalacyjnego.Zapiszjego kopię w utworzonym folderze pod nazwą ContactInfo.mxi.Odszukaj na dyskutwardym folder aplikacji Extension Manager.Znajdz w nim folderDreamweaver/Samples.Plik blank.mxi powinien znajdować się w tym właśniefolderze.(Rysunek 22.31 pokazuje, gdzie szukać poszczególnych pozycji.) Po utworzeniukopii pliku, otwórz ContactInfo.mxi w edytorze tekstu.Rys.22.31.Struktura folderaaplikacji ExtensionManager i plikisample.mxi orazblank.mxiPoczątek ramkiPodpowiedzMacromedia udostępnia dokładne instrukcje tworzenia plików instalacyjnych, dostępne w plikuPDF.Idz pod adres www.macromedia.com/exchange/dreamweaver i kliknij połączenieExtension Testing w sekcji Site Help.Koniec ramki3.Wypełnij dokument informacjami na temat obiektu.Postać dokumentu jest jużodpowiednia, a sposób formatowania możesz podglądnąć w pliku sample.mxi.Wprzypadku Twojego rozszerzenia, wprowadz w pliku brakujące informacje tak, by efektkońcowy prezentował się mniej więcej tak, jak na rysunku 22.32.Oto kilka podpowiedzi:Author name podaj tu swoje nazwisko (John Smith, Web Genius tak jest w naszymprzykładzie; nie ma przeciwwskazań, aby być odrobinę dowcipnym).File Name wpisz tu pełną ścieżkę dostępu z foldera głównego aplikacji Dreamweaver,tak jak w przykładzie.Jeśli chcesz, by rozszerzenie tworzyło nowe foldery jakopodrzędne względem istniejących, umieść je jako część ścieżki (w przykładzie jest tofolder test, który zostanie utworzony jako podrzędny względem foldera Objects).Gdyby obiekt zawierał jakieś dodatkowe foldery, podrzędne względem foldera Shared,także zostałyby one dodane w ten sam sposób
[ Pobierz całość w formacie PDF ]
