Skip to content

Commit 5cac721

Browse files
delphidabblerdelphidabbler
committed
Add new arrayutils holding page
1 parent 925171b commit 5cac721

File tree

1 file changed

+169
-0
lines changed

1 file changed

+169
-0
lines changed

‎_software/arrayutils.html

Lines changed: 169 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,169 @@
1+
---
2+
dl-file-prefix: "dd-arrayutils-"
3+
layout: "codelib-tplt"
4+
group: lib
5+
priority: 3
6+
version: "N/a"
7+
release-date: "TBA"
8+
platforms: ["Win32", "Win64"]
9+
frameworks: ["RTL"]
10+
compatibility: "Delphi XE & later"
11+
title: "Array Utilities Unit"
12+
precis: "Code that operates on generic arrays"
13+
summary: "Advanced Delphi record contains methods that operate on generic arrays."
14+
meta-title: "Array Utilities Unit for Delphi Pascal | Open Source | 32 & 64 bit"
15+
meta-desc: "Advanced Delphi Pascal record that acts as a container for static class methods that operate on and provide information about generic arrays. For Delphi XE and later."
16+
download-base-url: "https://github.com/ddablib/arrayutils/releases/"
17+
repo-url: "https://github.com/ddablib/arrayutils/releases"
18+
docs-url: "https://lib-docs.delphidabbler.com/ArrayUtils/"
19+
want-header-buttons: false
20+
status: "current"
21+
---
22+
{% assign dl-file = page.dl-file-prefix | append: page.version | append: ".zip" %}
23+
{% assign dl-url = page.download-base-url | append: dl-file %}
24+
25+
<section class="panel panel-default">
26+
<div class="panel-heading">
27+
<h2 class="panel-title">
28+
<!-- Overview -->
29+
Coming Soon
30+
</h2>
31+
</div>
32+
<div class="panel-body">
33+
<p>
34+
This is a holding page for the forthcomming Array Utilities Unit.
35+
</p>
36+
<!-- <p>
37+
This unit, named <code>DelphiDabbler.Lib.ArrayUtils.pas</code>, provides a single Delphi Pascal &quot;Advanced&quot; record, <var>TArrayUtils</var>, that provides operations upon and information about generic arrays.
38+
</p>
39+
<h3>
40+
Testing
41+
</h3>
42+
<p>
43+
<em>DUnit</em> tests for <var>TArrayUtils</var> are included in the download.
44+
</p>
45+
<h3>
46+
Example Code
47+
</h3>
48+
<p>
49+
Each method of <var>TArrayUtils</var> has example code included in the method's online documentation. The same example code is included in the download.
50+
</p> -->
51+
</div>
52+
</section>
53+
54+
<!-- <section class="panel panel-default">
55+
<div class="panel-heading">
56+
<h2 class="panel-title">
57+
Get The Code
58+
</h2>
59+
</div>
60+
<div class="panel-body">
61+
<p>
62+
You can download the latest version of the <em>{{page.title}}</em> directly from GitHub as <code>{{ dl-file }}</code>.
63+
</p>
64+
<p class="text-center">
65+
<a class="btn btn-primary" role="button" href="{{ dl-url }}" aria-label="Go to GitHub and download latest version">Download <span class="hidden-xs">release </span>v{{ page.version }}<span class="hidden-xs"> from GitHub</span></a>
66+
</p>
67+
<p>
68+
The <em>{{ page.title }}</em> source code is hosted in the <a href="{{ page.repo-url }}" aria-label="Link to the ddablib/arrayutils repository on GitHub"><code>ddablib/arrayutils</code></a> GitHub repository. You can <code>git clone</code> or fork the repository as required.
69+
</p>
70+
</div>
71+
</section> -->
72+
73+
<!-- <section class="panel panel-default">
74+
<div class="panel-heading">
75+
<h2 class="panel-title">
76+
Installation
77+
</h2>
78+
</div>
79+
<div class="panel-body">
80+
<p>
81+
The <em>{{page.title}}</em> is supplied in a zip file. Before installing you need to extract all the files from the zip file, preserving the directory structure. The following files will be extracted:
82+
</p>
83+
<ul class="list-group">
84+
<li class="list-group-item">
85+
<strong><code>DelphiDabbler.Lib.ArrayUtils.pas</code></strong> &ndash; source code.
86+
</li>
87+
<li class="list-group-item">
88+
<code>README.md</code> &ndash; read-me file.
89+
</li>
90+
<li class="list-group-item">
91+
<code>CHANGELOG.md</code> &ndash; project change log.
92+
</li>
93+
<li class="list-group-item">
94+
<code>MPL-2.txt</code> &ndash; the Mozilla Public License v2.0.
95+
</li>
96+
<li class="list-group-item">
97+
<code>Documentation.URL</code> &ndash; short-cut to the class' online documentation.
98+
</li>
99+
</ul>
100+
<p>
101+
In addition to the above files you will find the <em>DUnit</em> tests for <code>DelphiDabbler.Lib.ArrayUtils.pas</code> in the <code>Test</code> sub-directory and the example code in the <code>Demos</code> directory.
102+
</p>
103+
<p>
104+
There are three possible ways to use the unit.
105+
</p>
106+
<ol class="wide">
107+
<li>
108+
The simplest way is to add <code>DelphiDabbler.Lib.ArrayUtils.pas</code> to your projects as you need it.
109+
</li>
110+
<li>
111+
To make the unit easier to re-use you can either copy it to a folder on your Delphi search path, or add the folder where you extracted the unit to the search path. You then simply use the unit as required without needing to add it to your project.
112+
</li>
113+
<li>
114+
For maximum portability you can add the unit to a Delphi design time package. If you need help doing this <a href="{{ site.data.core.install-to-ide-link }}" aria-title="see a tip on working with design time packages">see here</a>.
115+
</li>
116+
</ol>
117+
</div>
118+
</section> -->
119+
120+
<!-- <section class="panel panel-default">
121+
<div class="panel-heading">
122+
<h2 class="panel-title">
123+
Documentation
124+
</h2>
125+
</div>
126+
<div class="panel-body">
127+
<p>
128+
The <em>{{page.title}}</em> is comprehensively documented online <a href="{{ page.docs-url }}" aria-title="View the online documentation">here</a>
129+
</p>
130+
<p>
131+
Read-me file: <code><a href="https://github.com/ddablib/arrayutils/blob/main/README.md" aria-title="View the read me file in Markdown format">README.md</a></code>
132+
</p>
133+
<p>
134+
Change log: <code><a href="https://github.com/ddablib/arrayutils/blob/main/CHANGELOG.md" aria-title="View the change log in Markdown format">CHANGELOG.md</a></code>.
135+
</p>
136+
</div>
137+
</section> -->
138+
139+
<!-- <section class="panel panel-default">
140+
<div class="panel-heading">
141+
<h2 class="panel-title" id="feedback">
142+
Feedback &amp; Queries
143+
</h2>
144+
</div>
145+
<div class="panel-body">
146+
<p>
147+
If you find any bugs or want to suggest a new feature please report them using the <em>{{page.title}}</em> <a href="https://github.com/ddablib/arrayutils/issues">issue tracker</a>.
148+
</p>
149+
<p>
150+
If you have created a bug fix or have implemented a new feature please open a pull request for it.
151+
</p>
152+
<p>
153+
Should you have any queries about using the unit please read the <a href="{{ page.docs-url }}">documentation</a>. If you can't find an answer in the documentation then post a message in the <a href="https://github.com/orgs/ddablib/discussions">discussion group</a>.
154+
</p>
155+
</div>
156+
</section> -->
157+
158+
<!-- <section class="panel panel-default">
159+
<div class="panel-heading">
160+
<h2 class="panel-title">
161+
License
162+
</h2>
163+
</div>
164+
<div class="panel-body">
165+
<p>
166+
<span class="fa fa-copyright fa-pull-left fa-3x"></span> The <em>{{page.title}}</em> is open source. It is copyright &copy; 2013-2023 by <a href="https://en.gravatar.com/delphidabbler" aria-label="Peter Johnson's Gravatar account">Peter Johnson</a>. The source code is made available under the terms of the <a href="https://www.mozilla.org/MPL/2.0/" aria-label="Mozilla Public License v2.0 on mozilla.org">Mozilla Public License v2.0</a>. All relevant trademarks are acknowledged.
167+
</p>
168+
</div>
169+
</section> -->

0 commit comments

Comments
 (0)