-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathindex.html
214 lines (191 loc) · 10.7 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Debreate - Debian Package Builder</title>
<link rel="icon" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4AscDRImFa4OaQAAAshJREFUOMttk0toHHUYwH///zxjdxOz26wxVNG1oEWxBWmhEeqlPpBWLNFLQe2lSpEe0osHD168Cp6K3hQvFlqrxB4KpUirCD7apBVaxN24KWSzm51sZvYxu7Mz8/WQULJtv9v3+vE9FQ+RsWO113te7XDSXC0CGOOFspsvzPnfPHbx/li1VRn9YOVAvHjj/N5CM/fCDs3ERBZQ1OsBC5WYv72cZxd3Hwm+nbz6ACA7c/vEaO3X0++9msNybEQEjUYpTSIxhuEQ9TTfXWrgT+w+0Tq366t7gOyRf17RSwu/HN9/g73mKgVToYDf+1lWZRuHnBX6knJxUCQdm+b7y3XCyRcPtH54/qoGSGqL55+dhMpgmmu1mO3rHrl1j77XYGmwj+vVNaaCJu92/qCydJOXijaD5dKPAGbm4JU3k5X/xhumhaoL+U6TQd9DRGh2Qjw1QtlL6DcW0e2AbLRG9blPkdZKLnPwyhumhMFhlKLaTFhe72BW/qJVaIJl839rnHm/Q3r7T9qjVRIFeb/CmXAVSyskDN4yJQqfUZa7MVFtow2DNOoh/R5h2yYSC2UYoAGBKQtEBWBtR6KwaJImKMtBEJR2QKnhLVvDNg1gmBs5caS0RGEZ20VZDlgOSukt+Qplu0O2+gCszA6wXSTqljXd9QsAynJRljtcgQIsF9kEGMCCOYkxMr7h7/g/67A0Oyd+PcB2ESJiSbYANGkS8HhUIRVop3B54igYIH7dD8uzFzbuoFp6R8IumfmT7B/c4VYX/u1BkAjbbn7CtJ1yrQ0fJi8zsvN9pOOTVEszQ6fsFD47pZ948ot49FHYrMLUNsqwGURttJXBGdtJUi8R3/pttt/4/MsHnsl+5OPXzKf2nNVP78mqbB7SzXa0gbQ80vL1IK7Mz0Td05ce+o33QM5Hb+vc1CGVyRcBpO2V07Xluaj/9U/3x94F2q46mGvlu/wAAAAASUVORK5CYII=">
<link rel="stylesheet" type="text/css" href="/css/main.css">
<script type="text/javascript" src="/js/loader.js"></script>
<script type="text/javascript" src="/js/main.js"></script>
<script type="text/javascript" src="/js/footer.js"></script>
<!-- disable caching for debugging
<meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">
<meta http-equiv="Pragma" content="no-cache">
<meta http-equiv="Expires" content="0">
-->
</head>
<body>
<div class="title-box" id="top">
<div class="title">
<img class="logo" src="/res/debreate64.png">
<span>Debreate - Debian Package Builder</span>
</div>
</div>
<div class="main-box">
<div class="box flex-col" id="toc">
<h1 class="header">Contents</h1>
<ul>
<li><a href="#notice">Notice</a></li>
<li><a href="#description">Description</a></li>
<li><a href="#licensing">Licensing</a></li>
<li><a href="#starting">Starting Debreate</a></li>
<li><a href="#notes">Notes</a></li>
<ul>
<li><a href="#wxpython-compat">wxPython Compatibility</a></li>
<li><a href="#non-debian">Using on Non-Debian Systems</a></li>
</ul>
<li><a href="#links">Navigation, Links, & Downloads</a></li>
</ul>
</div>
<div class="box flex-col" id="notice">
<h1 class="header"><a href="#toc">Notice</a></h1>
<p><em>
The software is in a state of revival. The old versions that are labelled as "stable" do
not work well on modern operating systems. It is recommended to use a development version,
however it is still under heavy testing &
<a href="https://github.com/debreate/debreate/blob/master/BUGS.txt">may contain bugs</a>.
</em></p>
</div>
<div class="box flex-col" id="description">
<h1 class="header"><a href="#toc">Description</a></h1>
<p>
Debreate is a utility to aid in creating installable
<a href="https://wikipedia.org/wiki/Deb_(file_format)">Debian (.deb)</a> packages.
</p>
<p>
The goal behind the project is to make developing for Debian based Linux distributions more
appealing, with an easy to use interface for packaging applications, artwork, media, themes,
etc.
</p>
<p>
Currently, it only supports "binary" packaging which allows anything that does not require
being compiled from source, such as scripted applications or media. These packages can then
be used for personal distribution. Plans for using backends such as
<a href="https://salsa.debian.org/debian/dh-make">dh_make</a> & debuild (available in
<a href="https://packages.ubuntu.com/devscripts">devscripts package</a>) for creating source packages
are in the works. But source packaging can be quite different & is a must if you want to
get your packages into a distribution's official repositories or a
<a href="https://launchpad.net/">Launchpad</a>
<a href="https://wikipedia.org/wiki/Ubuntu#Package_Archives">
Personal Package Archive (PPA)</a>.
</p>
</div>
<div class="box flex-col" id="licensing">
<h1 class="header"><a href="#toc">Licensing</a></h1>
<p>
Debreate & libdbr are licensed under <a href="LICENSE.txt">MIT</a>.
</p>
</div>
<div class="box flex-col" id="starting">
<h1><a href="#toc">Starting Debreate (0.8 development versions)</a></h1>
<p>
If you installed Debreate through a package manager or using the supplied .deb package,
there will be an icon in your system's menu. If you downloaded the portable .zip or source
package, just execute the file named <tt>init.py</tt>.
</p>
<p>
Debreate requires two main sofware to launch successfully. It needs
<a href="https://python.org/">Python</a> (>=3.10) &
<a href="https://wxpython.org/">wxPython</a> (>=4.0.7, recommended at least 4.2.0). Most
major Linux distributions will have Python pre-installed. But you may need to install
wxPython manually if you are running Debreate portably. If wxPython is not found on the
system when launching it will prompt to install using <a href="https://pypi.org">pip</a>.
If <tt>init.py</tt> was not launched from a terminal command line, it will attempt to find
& open an appropriate terminal application for prompt input. If approved, it will
execute <tt>python3 -m pip install wheel attrdict3 wxPython</tt>. Once installed, the user
interface should open. Some terminals (gnome-terminal & mate-terminal) seem to drop the
process afterwards, so the GUI won't display until it is run again.
</p>
<p>
For other sofware that is required for full function, see the
<a href="https://github.com/debreate/debreate#requirements">README</a>.
</p>
</div>
<div class="box flex-col" id="notes">
<h1 class="header"><a href="#toc">Notes</a></h1>
<h2 class="header" id="wxpython-compat"><a href="#toc">wxPython Compatibility</a></h2>
<p>
Debreate relies heavily on wxPython for its user interface. Most linux distributions provide
versions from their package managers. As of writing this, Ubuntu supplies
<a href="https://packages.ubuntu.com/python3-wxgtk4.0">version 4.0</a>. However, there are
some things broken in 4.0 & 4.1 that have been fixed in version 4.2. Namely, the
directory tree control. If your wxPython version is less than 4.2.0, you will not be able
to use the built-in directory tree to add files to your project. Drag-and-drop from the
system filemanager still does work. The minimum required version to launch the application
is 4.0.7. Anything older, & the application will attempt to launch an error dialog with
a notification that the installed version is unsupported.
</p>
<p>
If your system's package manager does not supply version 4.2, it is recommended to install
the latest version via the <a href="https://pypi.org/project/wxPython/">Python Package
Index</a>. That can be done with the command <tt>python3 -m pip install wxPython</tt> or
<tt>pip3 install wxPython</tt>.
</p>
<p>
Unless fixes are backported to older versions, it is likely support for anything older than
4.2 will be dropped very soon. Because systems such as Ubuntu are not yet distributing the
latest release, it complicates things when installing Debreate from it's .deb package.
Previously wxPython was made to be a hard dependency. But as a workaround, since the
recommended version is not yet available, it is made as an alternative dependency to the
<a href="https://packages.ubuntu.com/python3-pip">python3-pip package</a>. This allows it
to be installed despite wxPython not being on the system. When launched without wxPython, it
attempts to prompt the user to install via pip.
</p>
<h2 class="header" id="non-debian"><a href="#toc">Using on Non-Debian Systems</a></h2>
<p>
The software is tested on Debian based systems. It is unknown how it will function on other
operating systems. It is likely the application will start, but package building will fail
unless the Debian packaging backend tools are installed.
</p>
<p>
Some testing has been done on Windows just to get the application running. As of yet, it
will not fully function.
</p>
<p>
Support for wxPython on Windows under the native Python installers seems to be lacking.
Attempts to install via pip have failed or ended up in corrupt packages. Fortunately, the
<a href="https://www.msys2.org/">MSYS2/MinGW-w64 project</a> provides a working package. It
can be installed via pacman (<tt>pacman -S <repo>-wxPython</tt>).
</p>
</div>
<div class="box l-col" id="links">
<h1 class="header">Navigation</h1>
<ul>
<li><a href="/help/usage.html">Using Debreate</a></li>
<li><a href="/help/translating.html">Translating Debreate</a></li>
<li><a href="/libdbr/">libdbr</a></li>
</ul>
<h1 class="header">Links</h1>
<ul>
<li><a href="https://github.com/debreate/debreate">GitHub Project</a></li>
<li><a href="https://gitlab.com/debreate/debreate">GitLab Project</a></li>
<li><a href="https://sourceforge.net/projects/debreate">SourceForge Project</a></li>
<li><a href="https://debreate.wordpress.com/">WordPress Page</a></li>
<li><a href="https://www.debian.org/doc/debian-policy/">Debian Policy Manual</a></li>
<li><a href="https://lintian.debian.org/tags">Lintian Tags</a></li>
<li><a href="https://www.freedesktop.org/wiki/Specifications/">freedesktop.org Specifications</a></li>
</ul>
</div>
<div class="box r-col">
<h1 class="header">Downloads</h1>
<h2 id="title-stable"></h2>
<ul id="assets-stable"></ul>
<h2 id="title-dev"></h2>
<ul id="assets-dev"></ul>
<h2>PPAs:</h2>
<ul>
<li><a href="https://launchpad.net/~antumdeluge/+archive/ubuntu/debreate">stable</a>
(currently outdated)</li>
<li><a href="https://launchpad.net/~antumdeluge/+archive/ubuntu/debreate-dev">
development</a></li>
</ul>
</div>
<div class="box flex-col">
<center><p>
<a href="#top">back to top</a>
</p></center>
</div>
</div>
<div class="background"></div>
</body>
</html>