El código para todos los proyectos de la familia Mozilla (como Firefox, Thunderbird, etc.) se combinan dentro de una sola estructura. La estructura contiene el código fuente y el codigo neceario para generar cada proyecto en las plataformas soportadas (Linux, Windows, Mac OS, etc).
Para simplemente dar un vistazo al código fuente de Mozilla, no es necesario descargarlo. Usted puede mirar y/o navegar el código fuente directamente desde MXR (Iniciar en https://mxr.mozilla.org/mozilla-central/source/ para visualizar el codigo completo de la rama HEAD) utilizando su navegador web.
Para modificar el código fuente, hay que adquirirlos ya sea descargando una imagen del código fuente o bien realizando una salida desde el control de de versiones actual (Mercurial).
Este documento describe la estructura de directorios que puede ser utilizada por client.mk
-- es decir, directorios que son usados en alguno de los productos del proyecto. Hay otros directorios en el repositorio CVS de Mozilla, como las de herramientas web y los del código base clásico.
Estos no estan completamente actualizados. Hecha un vistazo al resumen del directorio de codigo fuente para obtener una versión un poco diferente de la misma información (más vieja). También ver para obtener más detalle sobre las partes de Gecko.
accessible
Contiene todos los archivos para la accesibilidad (Por ejemplo el MSAA (Microsoft Active Accessibility), ATK (Accessibility Toolkit, usado por GTK+ 2)y archivos de soporte). Ver Comunidad para la Accesibilidad de Mozilla.
browser
Contiene el código de front-end (en XUL, Javascript, XBL y C + +) para el navegador Firefox. Muchos de estos archivos iniciaron como una copia de los archivos en xpfe/.
build
Archivos varios utilizados por el proceso de construcción. Ver también config/.
caps
Gestión de la seguridad de las paginas web basado en la capacidad.
código para la determinación de las capacidades de contenido basado en la configuración de seguridad o certificados (por ejemplo, VeriSign). Consulte Seguridad de Componentes.
chrome
Registro Chrome utiliza con kit de herramientas. Estos archivos fueron originalmente copias de los archivos en rdf/chrome/.
config
Más archivos usados por el proceso de construcción, archivos de inclusión comunes para los makefiles, etc. Consulte Construcir/.
content
Las estructuras de datos que representan la estructura de páginas Web (HTML, SVG, documentos XML, elementos, nodos de texto, etc.) Estos objetos contienen la implementación de muchas interfaces DOM y también poner en práctica algunos comportamientos asociados con esos objetos, como maniobra de enlace, el comportamiento de control de formularios (form) y el envío de formularios.
This directory also contains the code for XUL, XBL, XTF, <canvas>, as well as the code implementing XSLT and event handling.
db
Contenedor para los modulos de acceso a bases de datos.
db/sqlite3
Base de datos SQLit, utilizada por el almacenamiento.
dbm
El código fuente de la biblioteca de base de datos Berkeley, hackeado en la versión 4.4BSD. Utilizado principalmente por código NSS como almacén de certificados.
docshell
Aplicación del docshell, el objeto principal de la gestión de las cosas relacionadas con una ventana de documento. Cada cuadro tiene su propia docshell. Contiene métodos para la carga de los URI, la gestión de URI oyentes contenido, etc Es la capa más externa de la API de la incrustación se utiliza para insertar un navegador Gecko en una aplicación. See also webshell/.
dom
Contiene:
- La definicienes IDL de las interfaces definidas por la especificación DOM y las Extensiones de Mozilla para esas interfaces.
- Las partes de la conexión entre JavaScript y las implementaciones de objetos DOM que son específicas tanto para JavaScript y en DOM. (las partes que no son especificas de DOM, es decir, el enlace generico entra XPCOM y JavaScript, se encuentran en js/src/xpconnect/.)
- Implementaciones de algunos de los principales objectos "DOM Nivel 0", como
window
,window.navigator
,window.location
, etc.
editor
Este directorio contiene interfaces C++, codigo C++ y XUL/JavaScript para el componente Editor integrable, que se utiliza para el editor HTML, para la composición de correo plano y HTML, y para campos de texto y áreas de texto en todo el producto. El editor está diseñado como una "ventana de navegador con funciones de edición": agrega algunas clases especiales para la edición de texto y la gestión de operaciones de deshacer / rehacer, pero reutiliza código del navegador para casi todo lo demás.
Contiene:
- El backend para HTML y edición de texto. Esto no sólo se utiliza para el editor de correo y editor de páginas, Ver Editor Mozilla.
- La interfaz para el editor de HTML que forma parte de SeaMonkey.
embedding
XXX this needs a description. See Embedding.
extensions
Contains several extensions to mozilla, which can be enabled at compile-time using the --enable-extensions
configure argument.
Note that some of these are now built specially and not using the --enable-extensions
option. For example, disabling xmlextras is done using --disable-xmlextras
.
extensions/auth
Implementation of the negotiate auth method for HTTP and other protocols. Has code for SSPI, GSSAPI, etc. See Integrated Authentication.
extensions/content-packs
Content- and locale-pack switching user interface.
extensions/cookie
Permissions backend for cookies, images etc, as well as the user interface to these permissions and other cookie features.
extensions/cview
Component viewer, which allows to view the currently registered components and interfaces.
extensions/datetime
Support for the datetime protocol.
extensions/finger
Support for the finger protocol.
extensions/gnomevfs
Interface to gnome-vfs to allow using all protocols supported by gnome-vfs inside of mozilla.
extensions/help
Help viewer and help content. See Mozilla Help Viewer Project.
extensions/irc
This is ChatZilla, the IRC (Internet Relay Chat) component. See ChatZilla.
extensions/java
XPCOM<->Java bridge ("JavaXPCOM", formerly known as Javaconnect). Unrelated to the code in java/.
extensions/layout-debug
Layout debugger. Intended as replacement for "viewer". Can be used to run layout regression tests and has support for other layout debugging features.
extensions/lightning
The Lightning project, "an extension to tightly integrate calendar functionality (scheduling, tasks, etc.) into Thunderbird." See Lightning.
extensions/mono
A two-way bridge between the CLR/.NET/Mono/C#/etc. world and XPCOM.
extensions/p3p
Implementation of W3C's Platform for Privacy Preferences standard. See Platform for Privacy Preferences (P3P).
extensions/pref
Preference-related extensions:
extensions/python
Support for implementing XPCOM components in python. See PyXPCOM.
extensions/reporter
An extension to report problems with web pages. Client-side part. See Mozilla Reporter.
extension/schema-validation
Allows to validate XML trees according to specified XML Schemas.
extension/spatialnavigation
Spatial navigation, navigating between links of a document according to their on-screen position. See Spatial Navigation.
extensions/spellcheck
Spellchecker for mailnews and composer.
extensions/sql
Support for accessing SQL databases from XUL applications. See SQL Support in Mozilla.
extensions/sroaming
Session roaming, i.e. support for storing a profile on a remote server.
extensions/transformiix
XSLT support. XSL Transformations is a language used to transform XML documents into other XML documents. See XSL Transformations.
extensions/tridentprofile
Support for importing profiles from MSIE.
extensions/typeaheadfind
Find As You Type allows quick web page navigation when you type a succession of characters in the body of the displayed page. See Find As You Type.
extensions/universalchardet
Universal character set detector.
extensions/venkman
The JavaScript Debugger.
extensions/wallet
Password and Form Manager.
extensions/webdav
WebDAV code; exposes special APIs for accessing WebDAV servers. Used by the Calendar project.
extensions/webservices
Support for Webservices. See Web Services.
extensions/xforms
Code for the XForms extension. See XForms.
extensions/xmlextras
Several XML-related extensions. See XML Extras.
extensions/xml-rpc
XML Remote Procedure Calls. Unowned these days. See XML-RPC in Mozilla.
extensions/xmlterm
XMLTerm, a terminal implemented using mozilla technology. Only available on GTK builds.
gc
Container for garbage collection libraries, currently only boehm GC.
gfx
Contains interfaces that abstract the capabilities of platform specific graphics toolkits, along with implementations on various platforms. These interfaces provide methods for things like drawing images, text, and basic shapes. It also contains basic data structures such as points and rectangles used here and in other parts of Mozilla.
It is also the home of the new graphics architecture based on cairo (via a C++ wrapper called thebes). See NewGFXAPIs and GFXEvolution.
image
Image rendering library. Contains decoders for the image formats mozilla supports.
intl
Internationalization and localization support. See Internationalisation Projects.
- bidi
- Obsolete.
- chardet
- Code for "sniffing" the character encoding of Web pages.
- ctl
-
Code for dealing with Complex Text Layout, related to shaping of south Asian languages (not built by default, needs
--enable-ctl
). - locale
- Code related to determination of locale information from the operating environment.
- lwbrk
- Code related to line breaking and word breaking.
- strres
- Code related to string resources used for localization.
- uconv
- Code that converts (both ways: encoders and decoders) between UTF-16 and many other character encodings.
- unicharutil
- Code related to implementation of various algorithms for Unicode text, such as case conversion.
ipc
Container for implementations of IPC (Inter-Process Communication) mechanisms.
ipc/ipcd
The IPC daemon that is used for communication between several mozilla processes to support profile sharing. (Note that at the time of this writing (Dec 2005), profile sharing is not supported by mozilla).
jpeg
Source code of libjpeg, used by the mozilla image library.
js/src
The JavaScript engine, also known as SpiderMonkey. See also JavaScript.
js/jsd
JavaScript debugging library. See JavaScript Debugging.
js/src/xpconnect
Support code for calling JavaScript code from C++ code and C++ code from JavaScript code, using XPCOM interfaces. See XPConnect].
js/src/liveconnect
Liveconnect, the bridge between JavaScript and Java. See LiveConnect Overview.
l10n
Basically empty and not used by the mozilla build.
layout
Code that implements a tree of rendering objects that describe the types and locations of the objects that are displayed on the screen (such as CSS boxes, tables, form controls, XUL boxes, etc.), and code that manages operations over that rendering tree (such as creating and destroying it, doing layout, painting, and event handling). See documentation and other information.
- base
- Code that deals with the rendering tree.
- generic
- The basic rendering object interface and the rendering tree objects for basic CSS boxes.
- forms
- Rendering tree objects for HTML form controls.
- tables
- Rendering tree objects for CSS/HTML tables
- mathml
- Rendering tree objects for MathML.
- svg
- Rendering tree objects for SVG.
- xul
- Additional rendering object interfaces for XUL and the rendering tree objects for XUL boxes.
lib
Mostly unused; might be used on mac?
Thunderbird frontend files. Note that many thunderbird files are shared with Mozilla Mailnews and can be found under mailnews/.
mailnews
The mail and news backend code (e.g. code that manages folders, manages databases, or interacts with mail servers) and the frontend code for the SeaMonkey mail client, some of which is shared by Thunderbird.
modules/libimg
Contains libpng, used by the image library for PNG Image decoding.
modules/libjar
Code to read zip files, used for reading the .jar files that contain the files for the mozilla frontend.
modules/libpref
Library for reading and writing preferences.
modules/libreg
Library for reading the netscape binary registry files, used for the ~/.mozilla/appreg
file (registry.dat
on windows).
modules/oji
Support for the Java plugin (a bridge for plugging-in generic Java VMs). See Open JVM Integration (OJI).
Note: OJI may be removed from Mozilla 2.0 according to this post by Josh.
modules/plugin
Plugin support. Implements the Netscape Plugin API (NPAPI). See Plugins.
modules/staticmod
Helper files for static mozilla builds.
modules/zlib
Source code of zlib, used at least in the networking library for compressed transfers.
netwerk
Networking library, also known as Necko. Responsible for doing actual transfers from and to servers, as well as for URI handling and related stuff. See also Network library documentation.
nsprpub
Netscape Portable Runtime. Used as an abstraction layer to things like threads, file I/O and socket I/O. See Netscape Portable Runtime.
other-licenses
Contains libraries that are not covered by the MPL but used in some mozilla code.
parser/expat
Copy of the expat source code, which is the XML parser used by mozilla.
parser/html
The HTML parser (for everything except about:blank)
parser/xml
The code for integrating expat (from parser/expat) into Gecko.
parser/htmlparser
The legacy HTML parser that's still used for about:blank. Parts of it are also used for managing the conversion of the network bytestream into Unicode in the XML parsing case.
profile
Code for profile handling, the profile manager backend and frontend.
rdf
RDF handling APIs. See RDF and RDF.
Also contains the chrome registry code used by SeaMonkey, although toolkit apps (such as Firefox and Thunderbird) use the copy forked into chrome.
security
Contains NSS and PSM, to support cryptographic functions in mozilla (like S/MIME, SSL, etc). See Network Security Services (NSS) and Personal Security Manager (PSM).
storage
Storage: XPCOM wrapper for sqlite. Wants to unify storage of all profile-related data. Supersedes mork. See also Unified Storage.
suite
Newer parts of SeaMonkey-specific code. Older parts live in xpfe/.
themes
Contains the themes shipped with SeaMonkey. Classic and Modern at the time of this writing.
toolkit
The "new toolkit" used by Thunderbird, Firefox, etc. This contains numerous front-end components shared between applications as well as most of the XBL-implemented parts of the XUL language (most of which was originally forked from versions in xpfe/).
tools
Some tools which are optionally built during the mozilla build process, mostly used for debugging.
uriloader/base
Content dispatch in Mozilla. Used to load uris and find an appropriate content listener for the data. Also manages web progress notifications. See Document Loading: From Load Start to Finding a Handler and The Life Of An HTML HTTP Request.
uriloader/exthandler
Used to handle content that Mozilla can't handle itself. Responsible for showing the helper app dialog, and generally for finding information about helper applications.
uriloader/prefetch
Service to prefetch documents in order to have them cached for faster loading.
view
View manager. Contains cross-platform code used for painting, scrolling, event handling, z-ordering, and opacity. Soon to become obsolete, gradually.
widget
A cross-platform API, with implementations on each platform, for dealing with operating system/environment widgets, i.e., code related to creation and handling of windows, popups, and other native widgets and to converting the system's messages related to painting and events into the messages used by other parts of Mozilla (e.g. view/ and content/, the latter of which converts many of the messages to yet another API, the DOM event API).
xpcom
Cross-Platform Component Object Model. Also contains data structures used by the rest of the mozilla code. See also XPCOM Project.
xpfe
XPFE is the SeaMonkey frontend. It contains the XUL files for the browser interface, common files used by the other parts of the mozilla suite, and the XBL files for the parts of the XUL language that are implemented in XBL. Much of this code has been copied to browser/ and toolkit/ for use in Firefox, Thunderbird, etc.
xpfe/components
Components used by the Mozilla frontend, as well as implementations of interfaces that other parts of mozilla expect.
xpfe/bootstrap
Startup code for Mozilla. This contains the main/WinMain function. (Not used by "new toolkit" apps; for those, see toolkit/xre and the "app" directory for each specific app).
xpinstall
The installer, which contains code for installing Mozilla and for installing XPIs/extensions. This directory also contains code needed to build installer packages. See XPInstall and the XPInstall project page.