[Zalozenia] Struktura linkow

Zastanowmy sie czy encyklopedia ma byc encyklopedia Delphi, czy encyklopedia jezyka programowania (dowolnego) o budowanie strukturalnej oraz obiektowej. W takim wypadku mozna by stworzyc tabele ktora bedzie zawierala ID oraz nazwe encyklopedii. Dzieki temu jeden system moglby obslugiwac zarowno encyklopedie - np. o Delphi jak i Visual C++ np...

To co chcialem przedyskutowac to budowa odnosnikow. Zakladamy, ze zarowno modul, klasa moze zawierac opis. Oprocz opisu system powinien generowac liste klas oraz funkcji nalezacych do danego modulu. Powinna byc takze mozliwosc (tak jak w wikipedii) publikowania wolnych artykulow (np. lista operatorow jezyka). Wobec tego trzeba by bylo okreslic np. taka budowe linkow:

programowanie.org/unit/Windows
programowanie.org/class/TMemo

A co z metodami oraz wlasciwosciami?

programowanie.org/property/Lines

Ale do czego odnosi sie Lines? Nalezaloby umiescic w tym linku takze klase:

programowanie.org/property/TMemo/Lines

No dobrze, wlasicowosc Lines posiada rowniez metode Add() lecz chyba do tego nalezaloby skonstrulowac osobny link:

programowanie.org/method/TStringList/Add

Co sadzicie o takich linkach? A zwykly tekst (np. opis operatorow) moglby miec taki link:

programowanie.org/text/Operators

A funkcja? Mozna by tak:

programowanie.org/function/ShellExecute

Chociaz jest malo prawdopodobne aby kilka modulow zawieralo funkcje o tej samej nazwie, mozna by dodac oznaczenie modulu, aby wyraznie zaznaczyc z jakiego modulu pochodzi funkcja:

programowanie.org/function/ShellAPI/ShellExecute

Co o tym myslicie?

Zastanowmy sie czy encyklopedia ma byc encyklopedia Delphi, czy encyklopedia jezyka programowania (dowolnego) o budowanie strukturalnej oraz obiektowej. W takim wypadku mozna by stworzyc tabele ktora bedzie zawierala ID oraz nazwe encyklopedii. Dzieki temu jeden system moglby obslugiwac zarowno encyklopedie - np. o Delphi jak i Visual C++ np...

jestem za

a linki ?
zamiast

programowanie.org/property/TMemo/Lines
bym dał

programowanie.org/property.php?class=TMemo&property=Lines

no ale w przypadku encykopedii multi językowj musiało by być

programowanie.org/property.php?language=Delphi&class=TMemo&property=Lines

i wtedy wszytkie linki ten sposób

Nie znam się na tym, ale pamiętajcie, aby budowac linki (i w ogóle cały serwis) w taki sposób, aby była łatwa możliwość wykorzystania np. google jako wyszukiwarki wewnętrznej - niektóre strony tak mają.

Wlasnie takie linki jakie zaprezentowalem sa ladne, eleganckie, czytelne i ladnie indeksowane przez wyszukiwarki, gdyz mysla one ze to sa kolejne katalogi.

Faktycznie bedzie jednak problem jezeli jeden system bedzie oblugiwal - np. encyklopedie Delphi oraz BCB. :/ Wtedy mozna wyswietlic strone ktora bedzie informowala, ze owa nazwa jest wieloznaczna i dac odnosniki to kilku wersji.

Ja pisal bym tak, jak jest to zrobione w Helpie D7.

haslo FileExists:

Tests if a specified file exists.

Unit

SysUtils

Category

file management routines

Delphi syntax:

function FileExists(const FileName: string): Boolean;

C++ syntax:

extern PACKAGE bool __fastcall FileExists(const AnsiString FileName);

Description

FileExists returns true if the file specified by FileName exists. If the file does not exist, FileExists returns false.

Czyli w opisie dac skladnie Delphi, C++ etc. Encyklopedia bedzie bardziej uniwersalna i wszystko bedzie wyczerpane w jednym hasle, nie trzeba bedzie szukac jednego w dziale Delphi, innego w C itd.

Uzupelniajac hasla z Delphi, bedzie mozna dodawac wpisy charakterystyczne dla Delphi 8 .NET. Np. opis klasy StringBuilder z przestrzeni nazw System.Text. Ale taka sama klasa z tej samej przestrzeni dostepna jest takze dla jezykow C# oraz Visual Basic.NET a takze C++ dla .NET itp.

Wiec mozna takze dodawac skladnie dla C# i dla innych jezykow? (tu tylko w przypadku .NET). Trzeba wiec rozrozniac hasla dla .NET oraz dla Win32. Jezeli chodzi o Win32, to funkcje Win32 API sa takie same dla Delphi, C++ itp. (roznia sie tylko skladnia). Jezeli chodzi o VCL to klasy sa takie same dla Delphi, BCB (rozna sie tylko skladnia). Jezeli chodzi o .NET to klasy sa takie same dla Delphi 8, C#, VB.NET (roznia sie tylo skladnia). Ufff... skomplikowany podzial :)