és mi az?
És mi az a nagyszerű ötlet?
Amúgy köszönöm, hogy leírtad, ezt az opciót nem ismertem. :)
- A hozzászóláshoz regisztráció és bejelentkezés szükséges
Drupal API és PHP referencia egy helyen
...
A jobb fajta, programozásra tervezett szövegszerkesztők tudják kezelni a külső *.chm, vagy *.html formátumban elérhető referenciákat. De a függvény leírást csak egy helyről próbálja meg elérni a szövegszerkesztő.
Tehát nincsen az, hogy ha nem sikerült elérni a leírást a http://localhost/phpdoc/html/function.hook_menu.html oldalon, akkor megpróbálja a http://localhost/ahol_van_az_oldalunk/api/function/hook_menu oldalon.
A megoldást abban láttam, hogy az API modult futtató Drupal példányba bele kell integrálni a PHP kézikönyvet, az API Merger modul segítségével.
Ehhez szintén szükség lesz a PHP kézikönyv egy helyi másolatára. (Bár próbáltam úgy megírni a modult, hogy működjön online is, de nem jött össze.)
A modul bekapcsolása után ellátogatni az admin/settings/apimerger oldalra.
A "PHP manual location" mezőbe ez kerüljön: http://localhost/phpdoc/html/ (a cikk alapján)
beállítások mentése
Továbbá az igazi API modul beállítsain is változtatni kell.
admin/settings/api
A "PHP Manual" részhez tartozik 2 db szövegmező. Az első marad változatlan. De a második
http://localhost/ahol_van_az_oldalunk/api/function/!function
Elvileg a
http://localhost/ahol_van_az_oldalunk/api/function/is_array
http://localhost/ahol_van_az_oldalunk/api/function/is-array
http://localhost/ahol_van_az_oldalunk/api/function/function.is-array.html
http://localhost/ahol_van_az_oldalunk/api/function/hook_menu
linkek is működni fognak.
- A hozzászóláshoz regisztráció és bejelentkezés szükséges
Doxygen
Végigolvasva a leírást, nem biztos, hogy mindenkinek érthető az, hogy milyen módon készül el a dokumentáció, hiszen a Drupal maga nem tartalmaz olyan különálló szöveges állományokat, melyek ezeket a leírásokat tartalmaznák.
Nos a Drupal forráskódja "öndokumentálóan" készül, a Doxygen rendszer segítségével. Ez a segédprogram képes arra, hogy a forráskódban elhelyezett speciális megjegyzéseket értelmezze, és abból elkészítse az adott programrész leírását.
Ez a nagy varázslat! :)
- A hozzászóláshoz regisztráció és bejelentkezés szükséges
különböző branch -ek
Még nem próbáltam ki az általad vázolt megoldást (ígéretesnek tűnik, bár jó lenne ismerni pár ilyen szövegszerkesztőt is), viszont érdemes lenne kipróbálni több Drupal branch dokumentálása esetén.
Ugyanis a node_load () függvény leírása a api/function/node_load/5 címen lesz elérhető, az utolsó perjel utáni érték (itt "5") az API modulban beállított "Short name" értéke. Ennek a szerepe az, hogy több különböző verziójú Drupal feldolgozása esetén meg tudja különböztetni az egyes verziókban szereplő azonos nevű függvényeket egymástól.
Na ezt szép barokkosan írtam le. :)
- A hozzászóláshoz regisztráció és bejelentkezés szükséges
lehet, hogy rosszul gondolom
Lehet, hogy rosszul gondolom, de ez eggyel több adatbázis-lekérdezést jelent, és ennyi. Szerintem elég körülményes manuálisan annyi álnevet rögzíteni a rendszerben, hogy észrevezető teljesítménycsökkenést okozzon.
- A hozzászóláshoz regisztráció és bejelentkezés szükséges
Nem csak a címeket kell
Nem csak a címeket kell beállítani, hanem a filtereket, mezőket is... Próbáltad?
- - -
Juhász Márton
- A hozzászóláshoz regisztráció és bejelentkezés szükséges
várjuk türelemmel
(pénteken leírtam, hogy mire kell figyelni egy ilyen rendszernél, de sajna megszűnt éppen az internet kapcsolat amikor be akartam küldeni, úgyhogy elveszett... ha lesz idő még egyszer leírom, most csak annyit, hogy ezek a kattintgatós megoldások bizonyos körülmények között nem jó választások.)
(Várjuk türelemmel, biztosan érdekes lesz.)
- A hozzászóláshoz regisztráció és bejelentkezés szükséges
Köszönöm
Köszönöm a tippet, sikerült! :)
Korábban már próbáltam, de nem "tudományos alapossággal". El volt dugva de sikerült megtalálni!
A megoldás valóban a "Nézet hozzáadása" menüpontban volt. Szűrők - mező - taxonómia. Fantasztikus! Kultúráltan ki lehet egy legördülő menüből választani a kategória "Értéket".
Én kézzel próbáltam beírni, persze nem működött :)
Mégegyszer köszi!
- A hozzászóláshoz regisztráció és bejelentkezés szükséges
Több branch - kipróbáltam
Ha az admin/settings/api oldalon megadsz több Drupal verziót, akkor be lehet állítani, hogy melyik legyen a Default Branch:
Figyelni kell, mert alaphelyzetben egyik rádió gomb sincsen benyomva. Csak a választás után lehet elhagyni az URL végéről a "Short name" -et.
Amúgy az apimerger modul mellőz mindenféle hibakezelést, és az eredményt sem kell mutogatni a HTML validátoroknak. :)
bár jó lenne ismerni pár ilyen szövegszerkesztőt is
(Windows felasználó vagyok)
Én jEdite-et használok. Az tud ilyet
Dev-PHP IDE is kezeli a *.chm fájlokat
Vannak olyan szövegszerkesztők amik saját maguk értelmezik a forrás fájlokban lévő dokumentációt, és gépelés közben egy kis ablakban feldobják a kurzor alatti függvénynévhez tartozó leírást. Ezek többnyire fizetős programok.
- A hozzászóláshoz regisztráció és bejelentkezés szükséges
php.ini bejegyzés
Létezik egy idevágó php.ini beállítás.
Nevezetesen a
A PHP hibaüzenetekben linkeké alakulnak a függvénynevek.
A cikkben leírtak kipróbálása közben, támadt egy nagyszerű ötletem. :-D
Mely így hangzik: ...