Skip to content

Commit cd6dfef

Browse files
authored
Website: 4.8.0 beta00018 release updates (apache#1395)
1 parent 08730de commit cd6dfef

10 files changed

Lines changed: 176 additions & 18 deletions

File tree

websites/site/contributing/documentation.md

Lines changed: 28 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -41,17 +41,24 @@ This ensures the website is always synched with the `master` branch and PRs that
4141

4242
### Build script
4343

44+
#### Local Build and Host
45+
4446
To build the website and run it on your machine, run the PowerShell script: `./websites/site/site.ps1` with the `-ServeDocs` flag. For example:
4547

46-
```
48+
```console
4749
./websites/site/site.ps1 -ServeDocs
4850
```
4951

5052
When executed this will build the site and host it at [http://localhost:8081](http://localhost:8081).
5153

54+
#### Release Build
55+
56+
> [!IMPORTANT]
57+
> The following steps are automated in the `Lucene-Net-Website.yml` workflow. This workflow runs automatically when a PR or branch that contains website changes is merged/pushed to the `master` branch. The workflow submits a new PR with the compiled website content to the `lucenenet-site` repository. The below information is provided in case the automation fails and the release needs to be done manually.
58+
5259
To build the website for release, run the script:
5360

54-
```
61+
```console
5562
./websites/site/site.ps1
5663
```
5764

@@ -137,17 +144,25 @@ publish docs site
137144

138145
### Build script
139146

147+
#### Local Build and Host
148+
140149
To build the api docs and run it on your machine, run the PowerShell script: `./websites/apidocs/docs.ps1`. For example:
141150

142-
```
151+
```console
143152
./websites/apidocs/docs.ps1 -ServeDocs -LuceneNetVersion 4.8.0-beta00008 -BaseUrl http://localhost:8080
144153
```
145154

146155
When executed this will build the site and host it at [http://localhost:8080](http://localhost:8080). _(Ensure to pass in the current version of Lucene.Net you are building.)_
147156

157+
#### Release Build
158+
159+
> [!IMPORTANT]
160+
> The following steps are automated in the `Lucene-Net-Documentation.yml` workflow. This workflow runs automatically when changes are pushed to the corresponding `docs/[Version]` branch. The workflow submits a new PR with the compiled API documentation content to the `lucenenet-site` repository. The below information is provided in case the automation fails and the release needs to be done manually.
161+
162+
148163
To build the api docs for release, run the script:
149164

150-
```
165+
```console
151166
./websites/apidocs/docs.ps1 -LuceneNetVersion 4.8.0-beta00008
152167
```
153168

@@ -156,13 +171,13 @@ This will build the site with all live parameters configured correctly and outpu
156171
The script parameters are:
157172

158173
- `-LuceneNetVersion` _(mandatory)_ This is the Lucene.Net version including pre-release information that is being built. For example: `4.8.0-beta00008`. _(This value will correspond to the folder and branch name where the docs get hosted, see below)_
159-
* `-ServeDocs` _(optional)_ A boolean switch. If present, it will build the docs and host the site. If not present it will build the static site to be hosted elsewhere.
160-
* `-Clean` _(optional)_ A boolean switch. If present, it will clear all caches and tool files before it builds again. This is handy if a new version of docfx is available or if there's odd things occurring with the incremental build.
161-
* `-DisableMetaData` _(optional)_ A boolean switch. If present it will disable the docfx metadata build operation of the docs build. Can be handy when debugging the docs build.
162-
* `-DisableBuild` _(optional)_ A boolean switch. If present it will disable the site building operation of the docs build. Can be handy when debugging the docs build.
163-
* `-DisablePlugins` _(optional)_ A boolean switch. If present it will not build the custom Lucene.Net `DocumentationTools.sln` docsfx plugins and exclude them from the build.
164-
* `-LogLevel` _(optional)_ Default is Warning. Options are: Diagnostic, Verbose, Info, Warning, Error.
165-
* `-BaseUrl` _(optional)_ Default is https://lucenenet.apache.org/docs/. Used to set the base URL of the docfx xref map files for cross linking between project builds.
174+
- `-ServeDocs` _(optional)_ A boolean switch. If present, it will build the docs and host the site. If not present it will build the static site to be hosted elsewhere.
175+
- `-Clean` _(optional)_ A boolean switch. If present, it will clear all caches and tool files before it builds again. This is handy if a new version of docfx is available or if there's odd things occurring with the incremental build.
176+
- `-DisableMetaData` _(optional)_ A boolean switch. If present it will disable the docfx metadata build operation of the docs build. Can be handy when debugging the docs build.
177+
- `-DisableBuild` _(optional)_ A boolean switch. If present it will disable the site building operation of the docs build. Can be handy when debugging the docs build.
178+
- `-DisablePlugins` _(optional)_ A boolean switch. If present it will not build the custom Lucene.Net `DocumentationTools.sln` docsfx plugins and exclude them from the build.
179+
- `-LogLevel` _(optional)_ Default is Warning. Options are: Diagnostic, Verbose, Info, Warning, Error.
180+
- `-BaseUrl` _(optional)_ Default is https://lucenenet.apache.org/docs/. Used to set the base URL of the docfx xref map files for cross linking between project builds.
166181

167182
### File/folder structure
168183

@@ -194,12 +209,12 @@ To use the dotnet tool you must download the current tag of the Java Lucene proj
194209

195210
Then install the tool:
196211

197-
```
212+
```console
198213
dotnet tool install javadoc2markdown --add-source https://pkgs.dev.azure.com/lucene-net/_packaging/lucene-net-tools/nuget/v3/index.json --tool-path ./
199214
```
200215

201216
Then run the command:
202-
```
217+
```console
203218
javadoc2markdown <LUCENE DIRECTORY> <LUCENENET DIRECTORY>
204219
```
205220

websites/site/docfx.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@
4242
"_appFaviconPath": "logo/favicon.ico",
4343
"_enableSearch": false,
4444
"_appLogoPath": "logo/lucene-net-color.png",
45-
"_appFooter": "Copyright &copy; 2025 The Apache Software Foundation, Licensed under the <a href='https://www.apache.org/licenses/' target='_blank'>Apache License, Version 2.0</a><br/> <small>Apache Lucene.Net, Lucene.Net, Apache, the Apache logo, and the Apache Lucene.Net project logo are either registered trademarks or trademarks of The Apache Software Foundation in the United States and other countries.</small>",
45+
"_appFooter": "Copyright &copy; 2026 The Apache Software Foundation, Licensed under the <a href='https://www.apache.org/licenses/' target='_blank'>Apache License, Version 2.0</a><br/> <small>Apache Lucene.Net, Lucene.Net, Apache, the Apache logo, and the Apache Lucene.Net project logo are either registered trademarks or trademarks of The Apache Software Foundation in the United States and other countries.</small>",
4646
"_gitContribute": {
4747
"repo": "https://github.com/apache/lucenenet",
4848
"branch": "master"

websites/site/docs.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ _disableBreadcrumb: true
1111

1212
The API docs are slightly different between versions, each one is listed below:
1313

14+
- [4.8.0-beta00018](https://lucenenet.apache.org/docs/4.8.0-beta00018/)
1415
- [4.8.0-beta00017](https://lucenenet.apache.org/docs/4.8.0-beta00017/)
1516
- [4.8.0-beta00016](https://lucenenet.apache.org/docs/4.8.0-beta00016/)
1617
- [4.8.0-beta00015](https://lucenenet.apache.org/docs/4.8.0-beta00015/)

websites/site/download/download.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,12 @@ uid: download
66

77
---
88

9+
## [Lucene 4.8.0-beta00018](xref:download/4.8.0-beta00018)
10+
11+
_Status:_ **`Beta`**
12+
13+
_Released:_ `2026-06-22`
14+
915
## [Lucene 4.8.0-beta00017](xref:download/4.8.0-beta00017)
1016

1117
_Status:_ **`Beta`**

websites/site/download/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
- name: Version 4.8.0-beta00018
2+
href: version-4.8.0-beta00018.md
13
- name: Version 4.8.0-beta00017
24
href: version-4.8.0-beta00017.md
35
- name: Version 4.8.0-beta00016
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
uid: download/4.8.0-beta00018
3+
version: 4.8.0-beta00018
4+
---
5+
6+
# Download Lucene.Net 4.8.0-beta00018
7+
8+
---
9+
10+
## Lucene 4.8.0-beta00018
11+
12+
_Status:_ **`Beta`**
13+
14+
_Released:_ `2026-06-22`
15+
16+
- Binary release: **[Lucene.Net-4.8.0-beta00018.bin.zip](https://www.apache.org/dyn/closer.lua/lucenenet/4.8.0-beta00018/Apache-Lucene.Net-4.8.0-beta00018.bin.zip)** [[PGP](https://downloads.apache.org/lucenenet/4.8.0-beta00018/Apache-Lucene.Net-4.8.0-beta00018.bin.zip.asc)] [[SHA512](https://downloads.apache.org/lucenenet/4.8.0-beta00018/Apache-Lucene.Net-4.8.0-beta00018.bin.zip.sha512)]
17+
- Source release: **[Lucene.Net-4.8.0-beta00018.src.zip](https://www.apache.org/dyn/closer.lua/lucenenet/4.8.0-beta00018/Apache-Lucene.Net-4.8.0-beta00018.src.zip)** [[PGP](https://downloads.apache.org/lucenenet/4.8.0-beta00018/Apache-Lucene.Net-4.8.0-beta00018.src.zip.asc)] [[SHA512](https://downloads.apache.org/lucenenet/4.8.0-beta00018/Apache-Lucene.Net-4.8.0-beta00018.src.zip.sha512)]
18+
- [Change log](https://github.com/apache/lucenenet/releases/tag/Lucene.Net_4_8_0_beta00018)
19+
20+
<div class="nuget-well" style="text-align:left;">
21+
PM> Install-Package Lucene.Net -Version 4.8.0-beta00018
22+
</div>
23+
24+
### Source code
25+
26+
- [Git Repository](https://github.com/apache/lucenenet)
27+
28+
### Supported Frameworks
29+
30+
- .NET 8.0
31+
- .NET 6.0
32+
- [.NET Standard 2.1](https://docs.microsoft.com/en-us/dotnet/standard/net-standard)
33+
- [.NET Standard 2.0](https://docs.microsoft.com/en-us/dotnet/standard/net-standard)
34+
- .NET Framework 4.6.2
35+
36+
### Remaining work
37+
38+
See **[Current Status](xref:contributing/current-status)** for more details on the remaining work
39+
40+
This version is a direct port of the Java Lucene project at [this release](https://github.com/apache/lucene-solr/releases/tag/releases%2Flucene-solr%2F4.8.0)
41+
42+
### All Packages
43+
44+
- [Lucene.Net](https://www.nuget.org/packages/Lucene.Net/) - Core library
45+
- [Lucene.Net.Analysis.Common](https://www.nuget.org/packages/Lucene.Net.Analysis.Common/) - Analyzers for indexing content in different languages and domains
46+
- [Lucene.Net.Analysis.Kuromoji](https://www.nuget.org/packages/Lucene.Net.Analysis.Kuromoji/) - Japanese Morphological Analyzer
47+
- [Lucene.Net.Analysis.Morfologik](https://www.nuget.org/packages/Lucene.Net.Analysis.Morfologik/) - Analyzer for dictionary stemming, built-in Polish dictionary
48+
- [Lucene.Net.Analysis.OpenNLP](https://www.nuget.org/packages/Lucene.Net.Analysis.OpenNLP/) - OpenNLP Library Integration
49+
- [Lucene.Net.Analysis.Phonetic](https://www.nuget.org/packages/Lucene.Net.Analysis.Phonetic/) - Analyzer for indexing phonetic signatures (for sounds-alike search)
50+
- [Lucene.Net.Analysis.SmartCn](https://www.nuget.org/packages/Lucene.Net.Analysis.SmartCn/) - Analyzer for indexing Chinese
51+
- [Lucene.Net.Analysis.Stempel](https://www.nuget.org/packages/Lucene.Net.Analysis.Stempel/) - Analyzer for indexing Polish
52+
- [Lucene.Net.Benchmark](https://www.nuget.org/packages/Lucene.Net.Benchmark/) - System for benchmarking Lucene
53+
- [Lucene.Net.Classification](https://www.nuget.org/packages/Lucene.Net.Classification/) - Classification module for Lucene
54+
- [Lucene.Net.Codecs](https://www.nuget.org/packages/Lucene.Net.Codecs/) - Lucene codecs and postings formats
55+
- [Lucene.Net.Expressions](https://www.nuget.org/packages/Lucene.Net.Expressions/) - Dynamically computed values to sort/facet/search on based on a pluggable grammar
56+
- [Lucene.Net.Facet](https://www.nuget.org/packages/Lucene.Net.Facet/) - Faceted indexing and search capabilities
57+
- [Lucene.Net.Grouping](https://www.nuget.org/packages/Lucene.Net.Grouping/) - Collectors for grouping search results
58+
- [Lucene.Net.Highlighter](https://www.nuget.org/packages/Lucene.Net.Highlighter/) - Highlights search keywords in results
59+
- [Lucene.Net.ICU](https://www.nuget.org/packages/Lucene.Net.ICU/) - Specialized ICU (International Components for Unicode) Analyzers and Highlighters
60+
- [Lucene.Net.Join](https://www.nuget.org/packages/Lucene.Net.Join/) - Index-time and Query-time joins for normalized content
61+
- [Lucene.Net.Memory](https://www.nuget.org/packages/Lucene.Net.Memory/) - Single-document in-memory index implementation
62+
- [Lucene.Net.Misc](https://www.nuget.org/packages/Lucene.Net.Misc/) - Index tools and other miscellaneous code
63+
- [Lucene.Net.Queries](https://www.nuget.org/packages/Lucene.Net.Queries/) - Filters and Queries that add to core Lucene
64+
- [Lucene.Net.QueryParser](https://www.nuget.org/packages/Lucene.Net.QueryParser/) - Text to Query parsers and parsing framework
65+
- [Lucene.Net.Replicator](https://www.nuget.org/packages/Lucene.Net.Replicator/) Files replication utility
66+
- [Lucene.Net.Sandbox](https://www.nuget.org/packages/Lucene.Net.Sandbox/) - Various third party contributions and new ideas
67+
- [Lucene.Net.Spatial](https://www.nuget.org/packages/Lucene.Net.Spatial/) - Geospatial search
68+
- [Lucene.Net.Suggest](https://www.nuget.org/packages/Lucene.Net.Suggest/) - Auto-suggest and Spellchecking support
69+
- [Lucene.Net.TestFramework](https://www.nuget.org/packages/Lucene.Net.TestFramework/) - Framework for testing Lucene-based applications

websites/site/lucenetemplate/.htaccess

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@
3232
# version, with [R=301] signaling permanent redirects and [L] preventing further
3333
# rule processing.
3434
#
35-
# Note: This file is line ending and BOM sensitive. It MUST use LF line endings and
35+
# Note: This file is line ending and BOM sensitive. It MUST use LF line endings and
3636
# MUST NOT have a BOM.
3737

3838

@@ -41,5 +41,5 @@ RewriteEngine On
4141
# Redirect /docs/latest/ to /docs/3.0.3/
4242
RewriteRule ^docs/latest/(.*)$ /docs/3.0.3/$1 [R=301,L]
4343

44-
# Redirect /docs/absolute-latest/ to /docs/4.8.0-beta00017/
45-
RewriteRule ^docs/absolute(?:-latest|Latest)/(.*)$ /docs/4.8.0-beta00017/$1 [R=301,L]
44+
# Redirect /docs/absolute-latest/ to /docs/4.8.0-beta00018/
45+
RewriteRule ^docs/absolute(?:-latest|Latest)/(.*)$ /docs/4.8.0-beta00018/$1 [R=301,L]

websites/site/lucenetemplate/partials/footer.tmpl.partial

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<footer>
22
<div class="container">
33
<span class="pull-left">
4-
{{{_appFooter}}}{{^_appFooter}}Copyright &copy; 2025 The Apache Software Foundation{{/_appFooter}}
4+
{{{_appFooter}}}{{^_appFooter}}Copyright &copy; 2026 The Apache Software Foundation{{/_appFooter}}
55
</span>
66
<div class="asf-links text-center">
77
<a href="{{_asfFoundationHref}}">{{_asfFoundationText}}</a> |

websites/site/lucenetemplate/styles/fonts.css

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,22 @@
1+
/*
2+
* Licensed to the Apache Software Foundation (ASF) under one
3+
* or more contributor license agreements. See the NOTICE file
4+
* distributed with this work for additional information
5+
* regarding copyright ownership. The ASF licenses this file
6+
* to you under the Apache License, Version 2.0 (the
7+
* "License"); you may not use this file except in compliance
8+
* with the License. You may obtain a copy of the License at
9+
*
10+
* http://www.apache.org/licenses/LICENSE-2.0
11+
*
12+
* Unless required by applicable law or agreed to in writing,
13+
* software distributed under the License is distributed on an
14+
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15+
* KIND, either express or implied. See the License for the
16+
* specific language governing permissions and limitations
17+
* under the License.
18+
*/
19+
120
@font-face {
221
font-family: 'Lato';
322
font-style: normal;
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
uid: releasenotes/4.8.0-beta00018
3+
version: 4.8.0-beta00018
4+
---
5+
6+
# Lucene.NET 4.8.0-beta00018 Release Notes
7+
8+
---
9+
10+
> This is a maintenance update that upgrades ICU4N to the latest version, since several serious concurrency and resource loading bugs have been patched since the last Lucene.NET release.
11+
12+
<!-- Release notes generated using configuration in .github/release.yml at Lucene.Net_4_8_0_beta00018 -->
13+
14+
## What's Changed
15+
### 🐞 Bug Fixes
16+
* FuzzyQuery produces a wrong result when prefix is equal to the term length by @paulirwin in https://github.com/apache/lucenenet/pull/1002
17+
* Validate PatternParser DTDs against expected name by @paulirwin in https://github.com/apache/lucenenet/pull/1358
18+
* Validate file paths for FSDirectory and Replicator by @paulirwin in https://github.com/apache/lucenenet/pull/1357
19+
* Bumped ICU4N to 60.1.0-alpha.440 by @NightOwl888 in https://github.com/apache/lucenenet/pull/1353
20+
* ShingleFilter produces invalid queries by @tohidemyname in https://github.com/apache/lucenenet/pull/946
21+
* Fix SegmentInfos replace doesn't update userData by @tohidemyname in https://github.com/apache/lucenenet/pull/948
22+
### 🚀 Performance Improvements
23+
* SWEEP: Replace J2N's TripleShift call with C# 11's unsigned right shift operator by @paulirwin in https://github.com/apache/lucenenet/pull/1007
24+
### 🏆 Improvements
25+
* Added "Improvements" Category for Release Notes by @NightOwl888 in https://github.com/apache/lucenenet/pull/1015
26+
### 📄 Website and API Documentation
27+
* website/site/.htaccess - bug fix by removing BOM and update to beta0017 redirection by @rclabo in https://github.com/apache/lucenenet/pull/1005
28+
* Updated .htaccess copy and release procedure by @NightOwl888 in https://github.com/apache/lucenenet/pull/1010
29+
* Added GitHub Automation for Release Notes by @NightOwl888 in https://github.com/apache/lucenenet/pull/1011
30+
* fix: Render ASF policy links in static HTML footer by @rbowen in https://github.com/apache/lucenenet/pull/1303
31+
* Fix/apidocs breadcrumb toc asf by @zka26 in https://github.com/apache/lucenenet/pull/1232
32+
* README: fix typo MacOS -> macOS by @jbampton in https://github.com/apache/lucenenet/pull/1179
33+
* Added ASF-required links using drop-down menu and unified navigation by @zka26 in https://github.com/apache/lucenenet/pull/1198
34+
* fix: Self-host all external website dependencies by @mmafrar in https://github.com/apache/lucenenet/pull/1197
35+
* Fix typos by @jbampton in https://github.com/apache/lucenenet/pull/1177
36+
* Replace lucene.testSettings.config references with lucene.testsettings.json by @paulirwin in https://github.com/apache/lucenenet/pull/1035
37+
38+
## New Contributors
39+
* @jbampton made their first contribution in https://github.com/apache/lucenenet/pull/1177
40+
* @mmafrar made their first contribution in https://github.com/apache/lucenenet/pull/1197
41+
* @rbowen made their first contribution in https://github.com/apache/lucenenet/pull/1303
42+
* @tohidemyname made their first contribution in https://github.com/apache/lucenenet/pull/946
43+
* @zka26 made their first contribution in https://github.com/apache/lucenenet/pull/1198
44+
45+
**Full Changelog**: https://github.com/apache/lucenenet/compare/Lucene.Net_4_8_0_beta00017...Lucene.Net_4_8_0_beta00018
46+

0 commit comments

Comments
 (0)