Difference between revisions of "User talk:Jeshyr"

From Dreamwidth Notes
Jump to: navigation, search
Line 1: Line 1:
 
[[Category: Development]]
 
[[Category: Development]]
 +
 +
** NOTE: Test version of this rewrite is being stored at http://wiki.dwscoalition.org/notes/User_talk:Rb for now **
  
 
This documents the contents of the $LJHOME development folder as checked out by <code>bootstrap.pl</code> and present on all Dreamhacks.
 
This documents the contents of the $LJHOME development folder as checked out by <code>bootstrap.pl</code> and present on all Dreamhacks.
Line 11: Line 13:
 
= cgi-bin =
 
= cgi-bin =
  
The code libraries that power the site.  This directory is the base of the library path--that is <code>use Net::OpenID::Consumer;</code> refers to the code in <code>cgi-bin/Net/OpenID/Consumer.pm</code>. It contains all the custom Perl libraries and functions that the code references including the <code>LJ::*</code> and <code>DW::*</code> libraries. Code in <code>*.pl</code> files in this directory are also library files but in an older style ([http://bugs.dwscoalition.org/show_bug.cgi?id=1726 bug 1726] refers to these updates).
+
Code libraries that power the site.  This directory is the base of the library path--that is <code>use Net::OpenID::Consumer;</code> refers to the code in <code>cgi-bin/Net/OpenID/Consumer.pm</code>. It contains all the custom Perl libraries and functions that the code references including the <code>LJ::*</code> and <code>DW::*</code> libraries. Code in <code>*.pl</code> files in this directory are also library files but in an older style ([http://bugs.dwscoalition.org/show_bug.cgi?id=1726 bug 1726] refers to these updates).
  
  
Line 42: Line 44:
 
= logs =
 
= logs =
  
Is this directory even used?
+
TODO: Is this directory even used?
  
  
 
= schemes =
 
= schemes =
  
The [[Template Toolkit]] (<code>*.tt</code>) files for generating the site schemes used on Dreamwidth.
+
[[Template Toolkit]] (<code>*.tt</code>) files for generating the site schemes used on Dreamwidth.
  
  
 
= src =
 
= src =
  
 +
TODO: Check this
 
Source code for some of the packages the code uses.  Perhaps this is the folder that comes with the distribution and <code>cvs</code> is checked out from the other repositories?  Does not contain all of the ones in <code>cvs</code> though.
 
Source code for some of the packages the code uses.  Perhaps this is the folder that comes with the distribution and <code>cvs</code> is checked out from the other repositories?  Does not contain all of the ones in <code>cvs</code> though.
  
Line 67: Line 70:
 
= temp =
 
= temp =
  
Probably used for temporary file storage, but what temporary files?
+
TODO: Probably used for temporary file storage, but what temporary files?
  
  
 
= test =
 
= test =
  
What's this?
+
TODO: What's this?
  
  

Revision as of 12:09, 3 September 2011


This documents the contents of the $LJHOME development folder as checked out by bootstrap.pl and present on all Dreamhacks.


bin

Backend utilities for maintaining and upgrading the site.


cgi-bin

Code libraries that power the site. This directory is the base of the library path--that is use Net::OpenID::Consumer; refers to the code in cgi-bin/Net/OpenID/Consumer.pm. It contains all the custom Perl libraries and functions that the code references including the LJ::* and DW::* libraries. Code in *.pl files in this directory are also library files but in an older style (bug 1726 refers to these updates).


cvs

Local version of the Mercurial repositories. Information about use of these repositories can be found in the [Developers' Initial Programming Notes].

The two Mercurial source branches you'll be using most often are dw-free dw-free and dw-nonfree dw-nonfree. (When viewing the Mercurial page for each repo, the 'Manifest' link in the top menu bar will allow you to browse the source tree.)


doc

Unedited versions of some configuration files are stored here.

raw

Docbook formatted source for the old and very much out of date docbook code for the LiveJournal server. LiveJournal's version is visible at http://livejournal.com/doc/server/ but Dreamwidth has not generated a user-visible copy.


etc

Various configuration files specific to the local site, such as ljconfig.pl. These files are not copied to the Mercurial repositories so they can be updated without affecting other running installations.


htdocs

User-facing BML pages, with the directory structure used on the main website. That is to say, anything that appears at http://www.dreamwidth.org/filename.bml will be here, as htdocs/filename.bml; anything at http://www.dreamwidth.org/directory/filename.bml will be here as htdocs/directory/filename.bml, etc.


logs

TODO: Is this directory even used?


schemes

Template Toolkit (*.tt) files for generating the site schemes used on Dreamwidth.


src

TODO: Check this Source code for some of the packages the code uses. Perhaps this is the folder that comes with the distribution and cvs is checked out from the other repositories? Does not contain all of the ones in cvs though.


ssldocs

This contains pages that are transmitted over SSL instead of being unencrypted. Regular files live in htdocs.


t

Tests that use the testing framework in main/test. See Dev Testing for how to use them.


temp

TODO: Probably used for temporary file storage, but what temporary files?


test

TODO: What's this?


views

Template Toolkit files which are gradually replacing the BML files. The controllers for the templates are in cgi-bin/DW/Controller/.