Merge pull request #1 from kjvbrt/update-ci

Update CI

.github/workflows/publish.yml

@@ -0,0 +1,18 @@
+name: 'Publish'
+on:
+  push:
+    branches:
+      - main
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout action
+        uses: actions/checkout@v4
+      - name: Prepare summary
+        run: python3 .ci/prepare.py
+      - name: Gitbook Action
+        uses: ZanderZhao/gitbook-action@master
+        with:
+          source_branch: main
+          token: ${{ secrets.FCC_GLOSSARY_TOKEN }}

CONTRIBUTING.md

@@ -25,19 +25,20 @@ By contributing, you are agreeing that we may redistribute your work under [CC-B
 
    There should be two `##`, followed by the definition. If this expands to something,
    you should add that in the same line after a colon, and then put a `{#hyperlink}` to just the unexpanded term.
-   
+
    If you link to another page, please use the format `«TERM»` or `«Title:TERM»` to make the link. This should work in both the final webpage and locally on GitHub.
 
 4.  Please install the [dependencies](#dependencies) if you want to build the glossary locally.
 
 
 ## Dependencies
 
-To build the glossary locally, install the following:
+To build the glossary locally, first follow the instructions how to install
+`gitbook-cli`:
 
-1. [Gitbook](https://github.com/GitbookIO/gitbook/blob/master/docs/setup.md)
+1. [Gitbook](https://github.com/GitbookIO/gitbook-cli)
 
-Install the Gitbook plugins:
+Afterwards, install the Gitbook plugins:
 
 ```shell
 $ gitbook install

README.md

@@ -1,10 +1,16 @@
-# FCC Glossary   [![Build Status](https://travis-ci.com/HEP-FCC/glossary.svg?branch=master)](https://travis-ci.com/HEP-FCC/glossary)
+# FCC Glossary
 
-Glossary of HEP and FCC-specific terms and concepts - online at <https://HEP-FCC.github.io/glossary/>.
+![publish workflow](https://github.com/HEP-FCC/glossary/actions/workflows/publish.yml/badge.svg)
 
-This is a fork of the original page created at LHCb, a project which is highly appreciated!
+Glossary of HEP and FCC-specific terms and concepts &mdash; online at <https://HEP-FCC.github.io/glossary/>.
+
+Contributions to the glossary are highly encouraged. Please see the
+[contributing guide](https://github.com/HEP-FCC/glossary/blob/master/CONTRIBUTING.md)
+in the [GitHub repository](https://github.com/HEP-FCC/glossary) for details.
 
 
+## Jump to a section
+
 [**A**](glossary/A.md)&nbsp;&nbsp;&nbsp;&nbsp;
 [**B**](glossary/B.md)&nbsp;&nbsp;&nbsp;&nbsp;
 [**C**](glossary/C.md)&nbsp;&nbsp;&nbsp;&nbsp;
@@ -33,5 +39,5 @@ This is a fork of the original page created at LHCb, a project which is highly a
 [**Z**](glossary/Z.md)
 
 
-Contributions to the glossary are highly encouraged. Please see the
-[contributing guide](https://github.com/HEP-FCC/glossary/blob/master/CONTRIBUTING.md) for details.
+This is a fork of the original page created at
+[LHCb](https://lhcb.github.io/glossary/), a project which is highly appreciated!

SUMMARY.md

@@ -1,6 +1,6 @@
-# LHCb Glossary
+# FCC Glossary
 
-Glossary of HEP and LHCb-specific terms and concepts.
+Glossary of HEP and FCC-specific terms and concepts.
 
 * [**A**](glossary/A.md)
 * [**B**](glossary/B.md)

glossary/A.md

@@ -5,6 +5,13 @@
 Analysis preservation tackles the topic of reproducibility of studies and results made by members of the collaboration.
 [Twiki](https://twiki.cern.ch/twiki/bin/view/LHCb/AnalysisPreservationReproducibility) for AP documentation in LHCb.
 
+
 ## AFS
 
 Shared filesystem used at CERN. Deprecated and in the course of being replaced by EOS. Fairly slow, so best not to use it for development and productions.
+
+
+## ASIC: application-specific integrated circuit {#ASIC}
+
+See the
+[Wikipedia definition](https://en.wikipedia.org/wiki/Application-specific_integrated_circuit).

glossary/D.md

@@ -1,15 +1,27 @@
 # D
 
+## DAQ {#DAQ}
 
+Acronym for Data Acquisition system. See the
+[Wikipedia introduction](https://en.wikipedia.org/wiki/Data_acquisition).
 
-## DIRAC: Distributed Infrastructure with Remote Agent Control {#DIRAC}
-
-DIRAC is the software framework for distributed computing used in LHCb.
-Official [DIRAC website](http://diracgrid.org/).
 
 ## DC: Drift chamber
 
+
 ## DCA: Distance Of Closest Approach {#DOCA}
 
 The shortest distance between a pair of tracks.
 
+
+## Delphes {#Delphes}
+
+A fully parametric fast simulation technique where not only the detector
+response, but also the reconstruction, is parametrized. See more in these
+[CHEP 2018 proceedings](https://www.epj-conferences.org/articles/epjconf/pdf/2019/19/epjconf_chep2018_02024.pdf).
+
+
+## DIRAC: Distributed Infrastructure with Remote Agent Control {#DIRAC}
+
+DIRAC is the software framework for distributed computing used in LHCb.
+Official [DIRAC website](http://diracgrid.org/).

glossary/N.md

@@ -0,0 +1,11 @@
+# N
+
+## Ntuple {#Ntuple}
+
+A columnar dataset in [ROOT](https://root.cern/) consisting of a list of
+independent columns, or *branches*. The branches typically contain variables
+representing fundamental types, simple classes/structures or list of variables.
+In ROOT, ntuples are represented with the
+[TTree](https://root.cern/doc/master/classTTree.html) class (a simpler
+[TNtuple](https://root.cern/doc/master/classTNtuple.html) class is provided for
+ntuples restricted to a list of float variables).