← Back to branch summary

~justas.sadzevicius/schooltool/flourish_timetables

« back to all changes in this revision

Viewing changes to README.txt

  • Committer: Gediminas Paulauskas
  • Date: 2011-02-23 14:26:22 UTC
  • mto: This revision was merged to the branch mainline in revision 2759.
  • Revision ID: menesis@pov.lt-20110223142622-qkgtmofbyeegf6qj
https://launchpad.net/bugs/371655
Use Liberation fonts instead of non-free Microsoft fonts (LP: #371655).

Show diffs side-by-side

added added

removed removed

Lines of Context:
README.txt
34
34
System requirements
35
35
-------------------
36
36
 
37
 
- Python 2.5 (http://www.python.org/)
 
37
- Python (http://www.python.org/)
38
38
 
39
39
- libicu-dev: International Components for Unicode libraries (http://icu.sourceforge.net/download/)
40
40
 
41
41
- the Python Imaging Library (PIL) (http://www.pythonware.com/products/pil/)
42
42
 
43
43
- (optional) the ReportLab Toolkit (http://www.reportlab.org), and
44
 
  Arial and Times New Roman TrueType fonts.  ReportLab is only needed if
45
 
  you want to generate PDF calendars.  To enable PDF support you will
 
44
  Liberation TrueType fonts.  ReportLab is only needed if you want to
 
45
  generate PDF reports and calendars.  To enable PDF support you will
46
46
  need to specify the path to fonts in the configuration file.
47
47
 
48
48
 
65
65
 
66
66
$ sudo apt-get install python-imaging
67
67
 
 
68
Optional: For pdf generation to work, you need to install fonts:
 
69
 
 
70
$ sudo apt-get install ttf-liberation
 
71
 
68
72
Run make to download and install all the required zope packages into
69
73
the eggs folder:
70
74
 
74
78
 
75
79
$ make test ftest
76
80
 
77
 
Create a fresh configuration file for yourself:
78
 
 
79
 
$ cp schooltool.conf.in schooltool.conf
80
 
 
81
 
Edit it with your favorite editor. If you want to - uncomment the line
 
81
Create a fresh instance:
 
82
 
 
83
$ make instance
 
84
 
 
85
The instance is created in instance directory. If you want to,
 
86
edit instance/schooltool.conf and uncomment the line
82
87
that says devmode on. This allows you to add sample data, view the
83
88
online docs and other useful things. You don't want to leave this on
84
89
for a production server, however.
85
90
 
86
 
After saving your new schooltool.conf, start your server:
 
91
Start your server:
87
92
 
88
93
$ make run
89
94
 
90
95
Go to http://localhost:7080 to see your new server in action.
91
96
 
92
 
Optional: To work with pdf generation, you need to pull a couple
93
 
packages from the "universe" and "multiverse" repositories. Packages
94
 
from these repositories are not supported by Canonical, but these
95
 
should work fine.
96
 
 
97
 
As a superuser (sudo) edit /etc/apt/sources.list to include this line
98
 
deb http://us.archive.ubuntu.com/ubuntu/ karmic universe multiverse
99
 
 
100
 
Then install the required package:
101
 
 
102
 
$ sudo apt-get install msttcorefonts
103
 
 
104
 
In case you're wondering, we need these fonts to support unicode in
105
 
our pdf's
106
 
 
107
97
 
108
98
Building SchoolTool from a checkout
109
99
----------------------------------------------
143
133
Project structure (checkout only)
144
134
--------------------------------------------
145
135
 
146
 
  GPL                   the GNU General Public License, version 2
 
136
  GPL.txt               the GNU General Public License, version 2
147
137
  README.txt            this file
148
138
  CHANGES.txt           release notes for the latest release
149
139
 
150
140
  Makefile              makefile for building extension modules
151
141
  setup.py              distutils setup script for building extension modules
152
 
  test.py               test runner
153
 
  remove-stale-bytecode.py
154
 
                        script to remove stale *.pyc files
155
142
 
156
143
  schooltool.conf.in    sample configuration file
157
144
 
284
271
Copyright information
285
272
---------------------
286
273
 
287
 
SchoolTool is copyright (c) 2003--2009 Shuttleworth Foundation
 
274
SchoolTool is copyright (c) 2003-2011 Shuttleworth Foundation
288
275
 
289
276
All files in the src/schooltool directory are part of SchoolTool, and
290
277
are (c) Shuttleworth Foundation, with the exception of translations in