diff --git a/2025/.gitignore b/2025/.gitignore new file mode 100644 index 0000000..f40fbd8 --- /dev/null +++ b/2025/.gitignore @@ -0,0 +1,5 @@ +_site +.sass-cache +.jekyll-cache +.jekyll-metadata +vendor diff --git a/2025/_config.yml b/2025/_config.yml new file mode 100644 index 0000000..5bd82ab --- /dev/null +++ b/2025/_config.yml @@ -0,0 +1,52 @@ +# Welcome to Jekyll! +# +# This config file is meant for settings that affect your whole blog, values +# which you are expected to set up once and rarely edit after that. If you find +# yourself editing this file very often, consider using Jekyll's data files +# feature for the data you need to update frequently. +# +# For technical reasons, this file is *NOT* reloaded automatically when you use +# 'bundle exec jekyll serve'. If you change this file, please restart the server process. +# +# If you need help with YAML syntax, here are some quick references for you: +# https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml +# https://learnxinyminutes.com/docs/yaml/ +# +# Site settings +# These are used to personalize your new site. If you look in the HTML files, +# you will see them accessed via {{ site.title }}, {{ site.email }}, and so on. +# You can create any custom variable you would like, and they will be accessible +# in the templates via {{ site.myvariable }}. + +title: AsHES 2025 Workshop +email: ashes@mcs.anl.gov +baseurl: "/2025" # the subpath of your site, e.g. /blog +url: "" # the base hostname & protocol for your site, e.g. http://example.com + +#twitter_username: jekyllrb +#github_username: jekyll + +# Build settings +#theme: minima +#plugins: +# - jekyll-feed + +# Exclude from processing. +# The following items will not be processed, by default. +# Any item listed under the `exclude:` key here will be automatically added to +# the internal "default list". +# +# Excluded items can be processed by explicitly listing the directories or +# their entries' file path in the `include:` list. +# +# exclude: +# - .sass-cache/ +# - .jekyll-cache/ +# - gemfiles/ +# - Gemfile +# - Gemfile.lock +# - node_modules/ +# - vendor/bundle/ +# - vendor/cache/ +# - vendor/gems/ +# - vendor/ruby/ diff --git a/2025/_includes/dates.html b/2025/_includes/dates.html new file mode 100644 index 0000000..eebb89c --- /dev/null +++ b/2025/_includes/dates.html @@ -0,0 +1,6 @@ +

Important Dates (AoE)

+
+

Paper Submission: TBD

+

Paper Notification: TBD

+

Camera-ready Deadline: TBD

+
diff --git a/2025/_includes/instructions.html b/2025/_includes/instructions.html new file mode 100644 index 0000000..04e9525 --- /dev/null +++ b/2025/_includes/instructions.html @@ -0,0 +1,15 @@ +

Papers Submission Instructions

+
+ +

Papers should present original research and should provide sufficient background material to make them accessible to the broader community.

+ +

Regular paper track submitted manuscripts may not exceed 10 single-spaced double-column pages using 10-point size font on 8.5x11 inch pages (IEEE conference style), including figures, tables, and references. See the style templates for latex or word for details.

+ +

Short paper track submitted manuscripts follow the same instructions as the regular manuscript but may not exceed 4 pages.

+ +

Submissions will be judged based on relevance, significance, originality, correctness, and clarity.

+ +

Submission site: https://easychair.org/conferences/?conf=ashes2024

+ +
+ diff --git a/2025/_includes/journal.html b/2025/_includes/journal.html new file mode 100644 index 0000000..37c948c --- /dev/null +++ b/2025/_includes/journal.html @@ -0,0 +1,4 @@ +

Journal Special Issue

+
+

TBD

+
diff --git a/2025/_layouts/default.html b/2025/_layouts/default.html new file mode 100644 index 0000000..619c455 --- /dev/null +++ b/2025/_layouts/default.html @@ -0,0 +1,78 @@ + + + + + + {{ page.title }} + + + +
+ +
+
+ + + + + + + + + +
+
+ The Fifteenth International Workshop on +
Accelerators and Hybrid Emerging Systems +
(AsHES) +
+
+ +
+
To be held in conjunction with +
39th IEEE International Parallel and Distributed Processing Symposium +
Milan, Italy +
Date TBD, 2025
+
+
+

+ +
+
+ + {{ content }} + + +
+ + diff --git a/2025/cfp.html b/2025/cfp.html new file mode 100644 index 0000000..6fbaa52 --- /dev/null +++ b/2025/cfp.html @@ -0,0 +1,58 @@ +--- +layout: default +title: AsHES Workshop +--- +
Under Constrution
+
+

Workshop Scope and Goals

+
+ +

The current computing landscape has witnessed a rapid and ongoing surge of change and innovation. This change has been driven by the relentless need to improve the energy-efficiency, memory, and computational throughput across all levels of the architectural hierarchy. The mounting volume of data that today's systems need to organize poses new challenges to the architecture, which can no longer be solved with classical, homogeneous designs. Advancements in all these areas have led Heterogeneous systems to become the norm rather than the exception.

+ +

Heterogeneous computing leverages a diverse set of computing (CPU, GPU, FPGA, TPU, DPU, etc.) and Memory (HBM, Persistent Memory, Coherent PCI protocols, etc.), hierarchical systems, and units to accelerate the execution of a diverse set of applications. Emerging and existing areas such as AI, BigData, Cloud Computing, Edge-Computing, Real-time systems, High-Performance Computing, and others have seen a real benefit due to Heterogeneous computer architectures. In addition, a new wave of accelerators based on dataflow architecture instead of the traditional von Neumann is sure to bring additional challenges and opportunities.

+ +

These new heterogeneous architectures often also require the development of new applications and programming models, to satisfy these new architectures and to fully utilize their capabilities. This workshop focuses on understanding the implications of heterogeneous designs at all levels of the computing system stack, such as hardware, compiler optimizations, porting of applications, and developing programming environments for current and emerging systems in all the above-mentioned areas. It seeks to ground heterogeneous system design research through studies of application kernels and/or whole applications, as well as shed light on new tools, libraries, and runtime systems that improve the performance and productivity of applications on heterogeneous systems.

+ +

The goal of this workshop is to bring together researchers and practitioners who are at the forefront of Heterogeneous computing to learn the opportunities and challenges in future Heterogeneous system design trends and thus help influence the next trends in this area.

+ + +

Topics of interest include (but are not limited to):

+ + +

Paper Tracks:

+ +

There are two paper tracks available for AsHES’24:

+ + +

Submitted papers will undergo a single-blind review process, so the authors do not need to anonymize a submission.

+ +
+ +{% include dates.html %} + +

Proceedings

+
+ The proceedings of this workshop will be published electronically together with IPDPS proceedings via the IEEE Xplore Digital Library. Instructions for authors can be found on the IPDPS 2024 webpage. +
+ +{% include instructions.html %} +{% include journal.html %} + +
diff --git a/2025/contact.html b/2025/contact.html new file mode 100644 index 0000000..d0b09ac --- /dev/null +++ b/2025/contact.html @@ -0,0 +1,21 @@ +--- +layout: default +title: AsHES Workshop +--- +
Under Constrution
+
+ +

Contact Address

+
+

Please send any queries about the AsHES workshop + to ashes@mcs.anl.gov

+
+ +

Mailing Lists

+
+

To hear announcements about AsHES, please subscribe to the + announcement mailing + list here.

+
+ +
diff --git a/2025/index.html b/2025/index.html new file mode 100644 index 0000000..a5238cf --- /dev/null +++ b/2025/index.html @@ -0,0 +1,44 @@ +--- +layout: default +title: AsHES Workshop 2025 +--- + +
+

DESCRIPTION OF THE WORKSHOP

+
+ IPDPS 2025 Logo + +

The development of ever larger and more energy-efficient computer systems in recent years has led to more and more systems with heterogeneous computing units (CPUs, GPUs or FPGAS) and systems with heterogeneous storage systems (High Memory Bandwidth). With the rise of persistent memory, attached to the PCIe bus or to the memory DIMMs, the border between storage and memory becomes more and more fluid. Other systems offer different types of compute nodes, so that a group of nodes build the accelerator (modular supercomputing). Hierarchical storage architectures, for example using burst buffers, try to overcome the IO problems. Programming such a system can be a real challenge along with locality, scheduling, load balancing, concurrency and so on.

+ +

This workshop focuses on understanding the implications of accelerators and heterogeneous designs on the hardware systems, porting applications, performing compiler optimizations, and developing programming environments for current and emerging systems. It seeks to ground accelerator research through studies of application kernels or whole applications on such systems, as well as tools and libraries and runtime systems that improve the performance and productivity of applications on these systems.

+ +

The goal of this workshop is to bring together researchers and practitioners who are involved in application studies for accelerators and other heterogeneous systems, to learn the opportunities and challenges in future design trends for HPC applications and systems.

+ +
+
+ {% include dates.html %} +
+ {% include journal.html %} +
+ +

Previous Workshops

+
+

AsHES 2024 in San Fransisco, California, USA

+

AsHES 2023 in St.Petersburg, Florida, USA

+

AsHES 2022 Virtual

+

AsHES 2021 Virtual

+

AsHES 2020 in New Orleans, USA

+

AsHES 2019 in Rio de Janeiro, Brazil

+

AsHES 2018 in Vancouver, Canada

+

AsHES 2017 in Orlando, USA

+

AsHES 2016 in Chicago, USA

+

AsHES 2015, + PLC 2015 in Hyderabad, India

+

AsHES 2014, + PLC 2014 in Phoenix, USA

+

AsHES 2013, + PLC 2013 in Boston, USA

+

AsHES 2012 in Shanghai, China

+

CACHES 2011 in Tucson, Arizona

+
+
diff --git a/2025/organizers.html b/2025/organizers.html new file mode 100644 index 0000000..83c42fa --- /dev/null +++ b/2025/organizers.html @@ -0,0 +1,70 @@ +--- +layout: default +title: AsHES Workshop +--- +
Under Constrution
+
+ +

Steering Committee

+
+

Pavan Balaji, Meta AI, USA

+

Yunquan Zhang, Chinese Academy of Sciences, China

+

Satoshi Matsuoka, RIKEN CCS, Japan

+

Jiayuan Meng, Argonne National Laboratory, USA

+

Xiaosong Ma, Qatar Computing Research Institute, Qatar

+

Barbara Chapman, Stony Brook University, USA

+

Guang R. Gao, University of Delaware, USA

+

Xinmin Tian, Intel, USA

+

Michael Wong, Codeplay, UK

+

James Dinan, NVIDIA, USA

+

Sunita Chandrasekaran, University of Delaware, USA

+

Antonio J. Peña, Barcelona Supercomputing Center (BSC), Spain

+

Min Si, Meta AI, USA

+

Lena Oden, FernUni Hagen, Germany

+

Simon Garcia de Gonzalo, Sandia National Laboratories, USA

+
+ +

General Chair

+
+

Shintaro Iwasaki, Meta AI, USA

+
+ +

Program Co-Chairs

+
+

Nikela Papadopoulou, University of Glasgow, UK

+

Carl Pearson, Sandia National Laboratories, USA

+
+ +

Web & Publicity Chair

+
+

Chloe Alverti, UIUC, USA

+
+ +

Technical Program Committee

+
+

Eishi Arima, Technical University of Munich, Germany

+

Paul F Baumeister, Forschungszentrum Julich GmbH, Germany

+

Rocio Carratala-Saez, Universidad de Valladolid, Spain

+

Adrian Castello, Universitat Politècnica de València, Spain

+

Ching-Hsiang Chu, Meta, USA

+

Christina Giannoula, University of Toronto, Canada

+

Bhavishya Goel, Chalmers University of Technology, Sweden

+

Juan Gomez-Luna, ETH Zurich, Switzerland

+

Gaurav Mitra, Meta, USA

+

Hiroyuki Ootomo, NVIDIA, USA

+

Guray Ozen, Google, USA

+

Sarunya Pumma, Meta

+

Michael Robson, Smith College, USA

+

Leonardo Solis-Vasquez, Technical University of Darmstadt, Germany

+

Pedro Valero-Lara, Oak Ridge National Laboratory, USA

+

Kun Wu, University of Illinois at Urbana-Champaign, USA

+

Felix Zahn, Max-Planck Institute, Germany

+
+ + +
diff --git a/2025/pics/ipdps2025-logo-300.jpg b/2025/pics/ipdps2025-logo-300.jpg new file mode 100644 index 0000000..47a6eac Binary files /dev/null and b/2025/pics/ipdps2025-logo-300.jpg differ diff --git a/2025/program.html b/2025/program.html new file mode 100644 index 0000000..8e769d9 --- /dev/null +++ b/2025/program.html @@ -0,0 +1,80 @@ +--- +layout: default +title: AsHES Workshop +--- +
Under Constrution
+
+
+

Opening Remarks

+

10:30 am - 10:40 am

+ +

Session 1: High-Performance Computing

+

10:40 am - 12:00 pm

+

Session Chair: Shintaro Iwasaki, Meta

+ + +

Lunch Break

+

12:00 pm - 1:00 pm

+ + +

Keynote

+

1:00 pm - 2:00 pm

+

Block-based GPU Programming with Triton

+

Philippe Tillet, OpenAI

+

Abstract: + Philippe Tillet + Traditional single instruction, multiple threads (SIMT) programming with CUDA can be daunting to machine learning researchers in need of fast custom kernels. This can significantly slow down the evaluation of novel research ideas that cannot be neatly decomposed into a set of pre-built, vendor-optimized primitives. In this talk, we will shed light on an alternative programming model which -- while relatively high-level -- aims to be more expressive than common graph-compilers (e.g., XLA, Torch-Inductor) and enable the use of custom data-structures (e.g., linked list, block-sparse tensors, etc.). We will specifically discuss the design and implementation of Triton, a mid-level programming language that uses block-based abstractions to simplify kernel development for researchers without deep GPU programming expertise. +

+

Bio: + Philippe Tillet first began working with GPUs in 2011 as a contributor to the ViennaCL library. He then received his B.S. from Telecom SudParis (France) in 2012, his M.S. from NCTU (Taiwan) in 2014, and his Ph.D. from Harvard University in 2020. He joined OpenAI full time in 2020 to pursue his work on the Triton compiler — a project he started in 2018 after being frustrated by the difficulty of writing auto-tuners for matrix multiplications in CUDA. Since then, he grew the Triton language into a reference for block-based programming model, and used it to write all the training kernels that were used by GPT4. +

+ +

Session 2: Accelerating AI/ML Workloads

+

2:00 pm - 3:10 pm

+

Session Chair: Carl Pearson, Sandia National Laboratories

+ + +

Closing Remarks

+

3:10 pm - 3:20 pm

+ +

Presentation

+ All presentations will be in-person. + Presenters are expected to target 25 minutes (full papers) or 15 minutes (short papers) for the talks with 5 minutes for questions. +
+
diff --git a/2025/reg.html b/2025/reg.html new file mode 100644 index 0000000..c95c6fb --- /dev/null +++ b/2025/reg.html @@ -0,0 +1,12 @@ +--- +layout: default +title: AsHES Workshop +--- + +
+

Workshop Registration

+
+

The AsHES workshop does not have a separate registration. All attendees need to register with the main +conference. Details can be found on the conference website.

+
+
diff --git a/2025/style/general.css b/2025/style/general.css new file mode 100644 index 0000000..c8567eb --- /dev/null +++ b/2025/style/general.css @@ -0,0 +1,219 @@ +/* Generic Settings */ +body { + font-family: Verdana, Arial, Helvetica, sans-serif; + color: #000000; + font-size: 13px; + text-align: justify; + background-color:#fff; + background-position: left top; +} + +div.midBox1 { + margin: 20px 8px 10px 8px; + padding: 8px 8px 0px 10px; +} + +img { + margin-top: 0px; + margin-bottom: 0px; + margin-right: 20px; + margin-left: 0px; +} + +img.right { + margin-top: 0px; + margin-bottom: 10px; + margin-right: 0px; + margin-left: 20px; +} + +h1 { + font-size: 14px; + color: white; + + /* 2024 color */ + background-color: #31328b; + + margin: 20px 0px 10px 0px; + padding: 8px 0px 0px 10px; + height: 25px; +} + +h2 { + font-size: 14px; + color: #FFF; + background-color:rgb(103, 107, 104); + margin: 20px 0px 10px 0px; + padding: 8px 0px 0px 10px; + height: 25px; +} + +h3 { + font-size: 14px; + padding-left: 8px; +} + +h4 { + padding-left: 8px; + font-weight: normal; +} + +li { + line-height:22px; + text-align:justify; +} + +p { + line-height:19px; +} + +a { + color:#E96F35; +} + +bold { + font-weight: bold; +} + + +/* Frames for content */ + +#main-frame { + width:1100px; + margin:auto; + background-color:white; + font-size:14px; +} + +#sub-frame { + width:968px; + margin:auto; + background-color:white; +} + + +/* Top-level title */ + +#title { + color:white; + margin: 8px 0px 8px 0px; + padding:0px; + line-height:30px; + font-size:20px; + font-weight:bold; + text-align:center; +} + +#subtitle { + color:white; + margin:8px 0px 8px 0px; + padding:0px; + line-height:30px; + font-size:12px; + font-weight: bold; + text-align:center; +} + +#subsubtitle { + color:black; + line-height:18px; + font-size:14px; + font-weight:bold; + text-align:center; +} + +#heading { + background-image: url(../pics/ipdps2025-logo-300.jpg); + background-position: 3% 40%; + background-repeat: no-repeat; + background-size: 25%; + + /* 2024 color */ + background-color: #31328b; +} + + +/* Top navigation bar */ + +#topnavigation { + height:35px; + + /* 2024 color */ + background-color: #c3584e; + + color:#ffffff; + font-size:12px; + line-height:18px; +} + +#topnavigation li { + list-style:none; + float:left; + text-align:center; +} + +#topnavigation a { + display:block; + text-decoration:none; + color:#ffffff; + padding:6px 35px 6px 35px; +} + +#topnavigation a:hover { + background-color:#754255; +} + +#topnavigation .rborder { + border-right:1px solid #754255; +} + +#topnavigation .lborder { + border-left:1px solid #754255; +} + + +/* Bottom navigation bar */ + +#bottomnavigation { + clear:both; + height:24px; + + /* 2024 color */ + background-color: #31328b; + + color:#fff; + text-align:center; + line-height:24px; +} + +#bottomnavigation a { + color:#fff; + text-decoration:none; +} + + +/* Generic description */ + +#description { + width:900px; + margin:auto; +} + + +/* Bottom copyright */ + +#copyright p { + text-align: center; + padding:0px 0px 10px 14px; +} + +/* Links */ +a { + color: #5672C1; + text-decoration: none; +} + +a:hover { + color: #445C88; + text-decoration: underline; +} diff --git a/2025/submission.html b/2025/submission.html new file mode 100644 index 0000000..ab577ea --- /dev/null +++ b/2025/submission.html @@ -0,0 +1,12 @@ +--- +layout: default +title: AsHES Workshop +--- +
Under Constrution
+
+ + {% include instructions.html %} + +
+ + diff --git a/Gemfile b/Gemfile index 4f78efa..3c83f5c 100644 --- a/Gemfile +++ b/Gemfile @@ -7,7 +7,7 @@ source "https://rubygems.org" # # This will help ensure the proper Jekyll version is running. # Happy Jekylling! -gem "jekyll", "~> 4.1.1" +gem "jekyll", "~> 4.3.4" # This is the default theme for new Jekyll sites. You may change this to anything you like. # gem "minima", "~> 2.5" # If you want to use GitHub Pages, remove the "gem "jekyll"" above and diff --git a/Gemfile.lock b/Gemfile.lock index 43cdcb3..9bae56c 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,88 +1,186 @@ GEM remote: https://rubygems.org/ specs: - addressable (2.7.0) - public_suffix (>= 2.0.2, < 5.0) + Ascii85 (1.1.1) + addressable (2.8.7) + public_suffix (>= 2.0.2, < 7.0) + afm (0.2.2) + async (2.17.0) + console (~> 1.26) + fiber-annotation + io-event (~> 1.6, >= 1.6.5) + bigdecimal (3.1.8) colorator (1.1.0) - concurrent-ruby (1.1.7) - em-websocket (0.5.2) + concurrent-ruby (1.3.4) + console (1.27.0) + fiber-annotation + fiber-local (~> 1.1) + json + em-websocket (0.5.3) eventmachine (>= 0.12.9) - http_parser.rb (~> 0.6.0) - ethon (0.12.0) - ffi (>= 1.3.0) + http_parser.rb (~> 0) + ethon (0.16.0) + ffi (>= 1.15.0) eventmachine (1.2.7) - ffi (1.13.1) + ffi (1.17.0-aarch64-linux-gnu) + ffi (1.17.0-aarch64-linux-musl) + ffi (1.17.0-arm-linux-gnu) + ffi (1.17.0-arm-linux-musl) + ffi (1.17.0-arm64-darwin) + ffi (1.17.0-x86-linux-gnu) + ffi (1.17.0-x86-linux-musl) + ffi (1.17.0-x86_64-darwin) + ffi (1.17.0-x86_64-linux-gnu) + ffi (1.17.0-x86_64-linux-musl) + fiber-annotation (0.2.0) + fiber-local (1.1.0) + fiber-storage + fiber-storage (1.0.0) forwardable-extended (2.6.0) - html-proofer (3.16.0) + google-protobuf (4.28.2) + bigdecimal + rake (>= 13) + google-protobuf (4.28.2-aarch64-linux) + bigdecimal + rake (>= 13) + google-protobuf (4.28.2-arm64-darwin) + bigdecimal + rake (>= 13) + google-protobuf (4.28.2-x86-linux) + bigdecimal + rake (>= 13) + google-protobuf (4.28.2-x86_64-darwin) + bigdecimal + rake (>= 13) + google-protobuf (4.28.2-x86_64-linux) + bigdecimal + rake (>= 13) + hashery (2.1.2) + html-proofer (5.0.9) addressable (~> 2.3) - mercenary (~> 0.3) - nokogumbo (~> 2.0) - parallel (~> 1.3) + async (~> 2.1) + nokogiri (~> 1.13) + pdf-reader (~> 2.11) rainbow (~> 3.0) typhoeus (~> 1.3) yell (~> 2.0) - http_parser.rb (0.6.0) - i18n (1.8.5) + zeitwerk (~> 2.5) + http_parser.rb (0.8.0) + i18n (1.14.6) concurrent-ruby (~> 1.0) - jekyll (4.1.1) + io-event (1.7.2) + jekyll (4.3.4) addressable (~> 2.4) colorator (~> 1.0) em-websocket (~> 0.5) i18n (~> 1.0) - jekyll-sass-converter (~> 2.0) + jekyll-sass-converter (>= 2.0, < 4.0) jekyll-watch (~> 2.0) - kramdown (~> 2.1) + kramdown (~> 2.3, >= 2.3.1) kramdown-parser-gfm (~> 1.0) liquid (~> 4.0) - mercenary (~> 0.4.0) + mercenary (>= 0.3.6, < 0.5) pathutil (~> 0.9) - rouge (~> 3.0) + rouge (>= 3.0, < 5.0) safe_yaml (~> 1.0) - terminal-table (~> 1.8) - jekyll-sass-converter (2.1.0) - sassc (> 2.0.1, < 3.0) + terminal-table (>= 1.8, < 4.0) + webrick (~> 1.7) + jekyll-sass-converter (3.0.0) + sass-embedded (~> 1.54) jekyll-watch (2.2.1) listen (~> 3.0) - kramdown (2.3.0) + json (2.7.2) + kramdown (2.4.0) rexml kramdown-parser-gfm (1.1.0) kramdown (~> 2.0) - liquid (4.0.3) - listen (3.2.1) + liquid (4.0.4) + listen (3.9.0) rb-fsevent (~> 0.10, >= 0.10.3) rb-inotify (~> 0.9, >= 0.9.10) mercenary (0.4.0) - mini_portile2 (2.4.0) - nokogiri (1.10.10) - mini_portile2 (~> 2.4.0) - nokogumbo (2.0.2) - nokogiri (~> 1.8, >= 1.8.4) - parallel (1.19.2) + nokogiri (1.16.7-aarch64-linux) + racc (~> 1.4) + nokogiri (1.16.7-arm-linux) + racc (~> 1.4) + nokogiri (1.16.7-arm64-darwin) + racc (~> 1.4) + nokogiri (1.16.7-x86-linux) + racc (~> 1.4) + nokogiri (1.16.7-x86_64-darwin) + racc (~> 1.4) + nokogiri (1.16.7-x86_64-linux) + racc (~> 1.4) pathutil (0.16.2) forwardable-extended (~> 2.6) - public_suffix (4.0.6) - rainbow (3.0.0) - rb-fsevent (0.10.4) - rb-inotify (0.10.1) + pdf-reader (2.12.0) + Ascii85 (~> 1.0) + afm (~> 0.2.1) + hashery (~> 2.0) + ruby-rc4 + ttfunk + public_suffix (6.0.1) + racc (1.8.1) + rainbow (3.1.1) + rake (13.2.1) + rb-fsevent (0.11.2) + rb-inotify (0.11.1) ffi (~> 1.0) - rexml (3.2.4) - rouge (3.24.0) + rexml (3.3.8) + rouge (4.4.0) + ruby-rc4 (0.1.5) safe_yaml (1.0.5) - sassc (2.4.0) - ffi (~> 1.9) - terminal-table (1.8.0) - unicode-display_width (~> 1.1, >= 1.1.1) - typhoeus (1.4.0) + sass-embedded (1.80.1-aarch64-linux-gnu) + google-protobuf (~> 4.28) + sass-embedded (1.80.1-aarch64-linux-musl) + google-protobuf (~> 4.28) + sass-embedded (1.80.1-arm-linux-gnueabihf) + google-protobuf (~> 4.28) + sass-embedded (1.80.1-arm-linux-musleabihf) + google-protobuf (~> 4.28) + sass-embedded (1.80.1-arm64-darwin) + google-protobuf (~> 4.28) + sass-embedded (1.80.1-x86-linux-gnu) + google-protobuf (~> 4.28) + sass-embedded (1.80.1-x86-linux-musl) + google-protobuf (~> 4.28) + sass-embedded (1.80.1-x86_64-darwin) + google-protobuf (~> 4.28) + sass-embedded (1.80.1-x86_64-linux-gnu) + google-protobuf (~> 4.28) + sass-embedded (1.80.1-x86_64-linux-musl) + google-protobuf (~> 4.28) + terminal-table (3.0.2) + unicode-display_width (>= 1.1.1, < 3) + ttfunk (1.8.0) + bigdecimal (~> 3.1) + typhoeus (1.4.1) ethon (>= 0.9.0) - unicode-display_width (1.7.0) + unicode-display_width (2.6.0) + webrick (1.8.2) yell (2.2.2) + zeitwerk (2.7.0) PLATFORMS - ruby + aarch64-linux + aarch64-linux-gnu + aarch64-linux-musl + arm-linux + arm-linux-gnu + arm-linux-gnueabihf + arm-linux-musl + arm-linux-musleabihf + arm64-darwin + x86-linux + x86-linux-gnu + x86-linux-musl + x86_64-darwin + x86_64-linux-gnu + x86_64-linux-musl DEPENDENCIES html-proofer - jekyll (~> 4.1.1) + jekyll (~> 4.3.4) BUNDLED WITH - 2.1.4 + 2.5.22 diff --git a/README.md b/README.md index 1a133b3..2901ab0 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,46 @@ If you need permisison to access [gitlab](https://gitlab.com/pmodels/websites/as ## How to Modify The following steps use the 2021 edition as the example. +This is a Jekyll site, so you need ruby. + +### Setting up a ruby environment (Ubuntu 22.04 LTS) + +```bash +git clone https://github.com/rbenv/rbenv.git ~/.rbenv + +# This will modify your .bashrc! +~/.rbenv/bin/rbenv init +``` + +get a new shell so rbenv works + +```bash +# install this plugin so `rbenv install` works +git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build + +# install prerequisite build libraries +apt-get install autoconf patch build-essential rustc libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libgmp-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libdb-dev uuid-dev + +#install a ruby +rbenv install 3.3.5 + +# set the ruby to be the one used for this project +rbenv local 3.3.5 +``` + +get a new shell + +```bash +ruby --version + +# this may give an error about things not being installed. Follow the directions to install the missing packages +cd 2025 +bundle exec jekyll serve +``` + +navigate to localhost:4000/2025/index.html in your browser and you should see the site + +### Getting Jekyll - `git clone git@github.com:pmodels/ashes-www.git ashes-www/` - Follow **quickstart** at https://jekyllrb.com/docs/ to create a local Jekyll environment under `ashes-www/2021` @@ -24,3 +64,5 @@ at [./maint/build.bash](https://github.com/pmodels/ashes-www/blob/master/maint/b and builds the static html files for each of them. For every newly added subsite, please add the folder name in `build.bash`. + +## Setting \ No newline at end of file diff --git a/maint/build.bash b/maint/build.bash index 8b53aaf..77b0050 100755 --- a/maint/build.bash +++ b/maint/build.bash @@ -1,7 +1,7 @@ #!/usr/bin/env bash set -e # halt script on error -subsites="2021 2022 2023 2024" +subsites="2021 2022 2023 2024 2025" maindest=./_site rm -rf $maindest