Skip to content

Commit

Permalink
Merge branch 'master' into generator-approach
Browse files Browse the repository at this point in the history
  • Loading branch information
sahitya-chandra authored Feb 2, 2025
2 parents 990c154 + ae25e36 commit 26a2a20
Show file tree
Hide file tree
Showing 14 changed files with 176 additions and 63 deletions.
2 changes: 1 addition & 1 deletion components/TOC.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ export default function TOC({ className, cssBreakingPoint = 'xl', toc, contentSe
// a-namedefinitionsapplicationaapplication slugWithATag contains transformed heading name that is later used
// for scroll spy identification
slugWithATag: item.content
.replace(/[<>?!:`'."\\/=]/gi, '')
.replace(/[<>?!:`'."\\/=@#$%^&*()[\]{}+,;]/gi, '')
.replace(/\s/gi, '-')
.toLowerCase()
}));
Expand Down
5 changes: 4 additions & 1 deletion components/buttons/ScrollButton.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,10 @@ function ScrollButton() {
return (
<div className='fixed bottom-14 right-4 z-40 h-16 w-12'>
{backToTopButton && (
<button className='rounded-full bg-white shadow-md ' onClick={scrollUp}>
<button
className='rounded-full bg-white shadow-md transition-all duration-300 ease-in-out hover:scale-110 hover:bg-[#8851FB]'
onClick={scrollUp}
>
<img src={scrollImage} alt='scroll to top' />
</button>
)}
Expand Down
12 changes: 6 additions & 6 deletions components/campaigns/banners.ts
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,11 @@ export function shouldShowBanner(cfpDeadline: string) {
export const banners = [
{
title: 'AsyncAPI Conference',
city: 'Paris Edition',
dateLocation: '5th of December, 2024 | France, Paris',
cfaText: 'Get Your Free Ticket',
eventName: 'the AsyncAPI Conf in Paris',
cfpDeadline: '2024-12-01T06:00:00Z',
link: 'https://conference.asyncapi.com/#tickets'
city: 'Singapore Edition',
dateLocation: '15th - 16th of April, 2025 | Marina Bay, Singapore',
cfaText: 'Apply To Speak',
eventName: 'the end of Call for Speakers',
cfpDeadline: '2025-02-24T06:00:00Z',
link: 'https://apidays.typeform.com/apidayscfp?typeform-source=www.apidays.global'
}
];
4 changes: 0 additions & 4 deletions components/footer/FooterList.ts
Original file line number Diff line number Diff line change
Expand Up @@ -60,10 +60,6 @@ export const initiativeLinks: InitiativeLink[] = [
label: 'Blog',
url: '/blog'
},
{
label: 'Shop',
url: 'https://www.store.asyncapi.com/'
},
{
label: 'Brand',
url: 'https://github.com/asyncapi/brand/blob/master/brand-guidelines/README.md'
Expand Down
3 changes: 3 additions & 0 deletions components/navigation/Filter.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,9 @@ export default function Filter({ data, onFilter, checks, className }: FilterProp

if (e) {
newQuery[check.name] = e;
} else {
// Remove a specific filter upon clicking Select Placeholder option
delete newQuery[check.name];
}
if (newQuery) {
const queryParams = new URLSearchParams(newQuery as { [key: string]: string }).toString();
Expand Down
31 changes: 0 additions & 31 deletions config/AMBASSADORS_MEMBERS.json
Original file line number Diff line number Diff line change
Expand Up @@ -416,37 +416,6 @@
}
]
},
{
"name": "Raphael De Lio",
"github": "raphaeldelio",
"twitter": "raphaeldelio",
"linkedin": "raphaeldelio",
"country": "🇧🇷",
"bio": "Raphael De Lio is a passionate software engineer who loves to think about solutions and ways to improve anything he touches. He was born in Brazil, lived in Portugal for five years, and now works as a consultant in the Netherlands. In his quest for knowledge, Raphael has always valued learning and sharing insights with others. This pursuit not only led him to Xebia, a place where he found a community of engineers who share his enthusiasm for technology and continuous improvement but also to becoming the co-organizer of the Amsterdam Kotlin MeetUp, where he has been able to enable other speakers to share their knowledge as well.",
"company": "Xebia",
"title": "Software Consultant at Xebia",
"img": "https://avatars.githubusercontent.com/u/25641721?v=4",
"contributions": [
{
"type": "article",
"title": "AsyncAPI — A standard specification for documenting Event-Driven Applications",
"date": {
"year": 2024,
"month": "February"
},
"link": "https://medium.com/@raphaeldelio/asyncapi-a-standard-for-documenting-event-driven-applications-8ff657119036"
},
{
"type": "presentation",
"title": "AsyncAPI & Springwolf - Automated documentation (and more)",
"date": {
"year": 2024,
"month": "May"
},
"link": "https://www.youtube.com/watch?v=DylvTW_ia4Y"
}
]
},
{
"name": "Hari Krishnan",
"github": "harikrishnan83",
Expand Down
14 changes: 7 additions & 7 deletions config/meetings.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,4 @@
[
{
"title": "Marketing WG Meeting",
"calLink": "https://www.google.com/calendar/event?eid=NDd1NzNqdWprNWdqc3U3aGsyZnBhOWpobXMgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
"url": "https://github.com/asyncapi/community/issues/1553",
"banner": "",
"date": "2024-10-22T14:00:00.000Z"
},
{
"title": "Marketing WG Meeting",
"calLink": "https://www.google.com/calendar/event?eid=MG9qY2RycjY2cm0xMW1ibTVpZGh2MXZuNjQgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
Expand Down Expand Up @@ -75,5 +68,12 @@
"url": "https://github.com/asyncapi/community/issues/1657",
"banner": "",
"date": "2025-02-04T14:00:00.000Z"
},
{
"title": "AsyncAPI Community Working Group Meeting",
"calLink": "https://www.google.com/calendar/event?eid=N2k4dGR0Nml1OG4wbDdjMWQ2ZDliNDZmcGMgY19xOXRzZWlnbG9tZHNqNm5qdWh2YnB0czExY0Bn",
"url": "https://github.com/asyncapi/community/issues/1668",
"banner": "https://github.com/user-attachments/assets/e0c22c5a-94a8-488c-970c-14aa1697283c",
"date": "2025-02-11T15:00:00.000Z"
}
]
142 changes: 142 additions & 0 deletions markdown/blog/conference-2024-summary.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,142 @@
---
title: "AsyncAPI Conference 2024 Report"
date: 2025-01-28T06:00:00+01:00
type: Communication
tags:
- Project Status
cover: /img/posts/2024-conference/banner-2024.webp
authors:
- name: Thulisile Sibanda
photo: /img/avatars/thulieblack.webp
link: https://www.linkedin.com/in/v-thulisile-sibanda/
byline: Community Builder and Open Source Fanatic!
excerpt: 'AsyncAPI Conference Summary for 2024'
featured: true
---
As the saying goes, `"The second time is a charm."` AsyncAPI Conf on Tour returned in 2024 for a set of events across different locations. Not only did we run in-person conferences, but we also brought back our beloved online conference this time around, making the whole experience complete.

In the AsyncAPI Conf on Tour 2023, I mentioned a few things I would love to improve; let's see what we changed, the challenges we faced, and what we are changing as we advance.


## Planning Process
After a successful partnership with the APIdays Paris event, they offered to sponsor a track at other events they were hosting. Given the positive outcome in Paris, we were eager to explore the options. We decided to hold three in-person events with APIdays as our venue and host sponsor.

Later in the year, I thought it would be a great idea to bring back the online conference to provide an opportunity for those who can't travel but still want to speak and share their expertise. This idea completed the entire experience, bringing the total number of events to four.

<Figure
src="/img/posts/2024-conference/venues.webp"
/>

For a detailed summary of what happened at each event, please read the following summaries:

- [AsyncAPI Conference Helsinki](https://www.asyncapi.com/blog/helsinki-and-community)
- [AsyncAPI Conference London](https://www.asyncapi.com/blog/2024-september-summary-and-london)
- [AsyncAPI Online Conference](https://www.asyncapi.com/blog/2024-october-summary)
- [AsyncAPI Conf in Paris](https://www.asyncapi.com/blog/2024-december-and-paris)

## Challenges
The first challenge we faced was that most of the conferences were held in Europe this time, and for many, obtaining a Schengen visa isn't an easy process.

Secondly, although we have a venue and host sponsor, we still need financial support to cover costs such as shipping swags and providing travel funding for speakers.

## Attendance
We had an incredible turnout for all our in-person events. The highlight was networking with community members, ambassadors, and friends at the APIs Standards booth. This booth became a hub for discussions with various companies and experts while maintaining vendor neutrality.

Over **580** people attended our in-person conference, and we had more than **450** views during our AsyncAPI Online Conference livestream. Additionally, the recorded sessions received over **446** views after the conference.

You can also catch up on the [recordings from the AsyncAPI Online Conference](https://youtube.com/playlist?list=PLbi1gRlP7pijItMBmw9SeeyWxuEa3jLR2&si=nFqLJrn50q4FNRIk).

## Conference Sponsors
AACoT'24 was possible thanks to [APIdays](https://www.apidays.global/), our Event Host and Sponsor. They not only provided a venue to host the conferences and sponsored us for lunch, breakfast, and refreshments, but we also had an `API Standards` booth.

<a href='https://www.apidays.global/' target='_blank'>
<img src='/img/posts/2023-summary/apidays-logo-2023.png' alt='apidays' width='500px' />
</a>

I want to thank our financial sponsors, [Gravitee.io](https://www.gravitee.io/) and [Postman](https://www.postman.com/), for supporting the conference. Thanks to their sponsorship, I traveled to London to support the event in person.
Additionally, we were able to provide partial assistance to speakers at the Paris conference and covered the logistics of swag shipment.

<a href='https://www.gravitee.io/' target='_blank'>
<img src='/img/sponsors/gravitee.io_logo.jpg' alt='gravitee.io' width='500px' />
</a>


<a href='https://www.postman.com/' target='_blank'>
<img src='/img/sponsors/postman.png' alt='postman' width='500px' />
</a>

## Special Shout Out
Firstly, my gratitude goes out to all the speakers for dedicating their time to share their expertise and provide valuable insights to the community.

Secondly, I want to thank all the community members who volunteered at the API Standards booth during the conference. Your commitment to sharing knowledge with attendees is greatly appreciated and does not go unnoticed.

Lastly, I am genuinely thankful for their hard work and commitment to assisting me behind the scenes. They led and contributed to the aspects that made the conference successful and even being a courier so that we could have materials and set up the booth tables.

<Profiles profiles={[
{
name: 'Lukasz Gornicki',
avatar: 'https://avatars.githubusercontent.com/derberg',
link: 'https://github.com/derberg'
},
{
name: 'Azeez Elegbede',
avatar: 'https://avatars.githubusercontent.com/acethecreator',
link: 'https://github.com/acethecreator'
},
{
name: 'Barbara Czyż',
avatar: 'https://avatars.githubusercontent.com/u/17266942?v=4',
link: 'https://www.linkedin.com/in/barbara-szwarc/'
},
{
name: 'Khuda Dad Nomani',
avatar: 'https://avatars.githubusercontent.com/u/32505158?v=4',
link: 'https://github.com/KhudaDad414'
},
{
name: 'Aishat Muibudeen',
avatar: 'https://avatars.githubusercontent.com/Mayaleeeee',
link: 'https://github.com/Mayaleeeee'
},
{
name: 'Oluwabamikemi Kayode',
avatar: 'https://avatars.githubusercontent.com/u/64528871?v=4',
link: 'https://github.com/iambami'
},
{
name: 'Ashmit Jagtap',
avatar: 'https://avatars.githubusercontent.com/u/69006513?v=4',
link: 'https://github.com/ashmit-coder'
}

]} />


## Where To In 2025?
For AsyncAPI Conference 2025, we are excited to announce that [APIdays](https://www.apidays.global/) will be hosting us in:
- Singapore on **the 15th - 16th of April**.
- Munich on **the 2nd - 3rd of July**.
- London on **the 22nd - 24th of September**.
- Paris on **the 9th -11th of December**.

[APIConf Lagos](https://apiconf.net/) will be hosting us in Lagos, Nigeria, on **the 18th - 19th of July**.

We will also have our annual AsyncAPI Online Conference on **the 29th of October**.

We are looking for financial sponsors, and if you know any company that will be interested, [please download and share our conference sponsorship prospectus](https://drive.google.com/file/d/1LxTFLWkRmFQkHOyrwZBL7yqSO2_XPJNq/view?usp=sharing).
You can also check out our [Open Collective Page](https://opencollective.com/asyncapi/events/asyncapi-conference-e9fd5b06) to explore sponsorship tiers.

Alternatively, for more details on partnerships, please email us at [[email protected]](mailto:[email protected]).

## Call for Speakers, Singapore

[The call for speakers for AsyncAPI Conf Singapore is now open](https://apidays.typeform.com/apidayscfp?typeform-source=www.apidays.global)! Send those proposals and share your knowledge and expertise with the community. The submission deadline is on the 23rd of February, so don't miss out.

When submitting your proposal, please follow these simple steps to ensure you choose the correct track:

1. Click on the link and select "Start."
2. Choose option A, "apidays Singapore 2025," and click "OK."
3. In the conference track selection, choose option I, "AsyncAPI."
4. After that, you can submit your details!

Looking forward to receiving your submissions!
20 changes: 10 additions & 10 deletions markdown/docs/tools/generator/usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ FLAGS
--map-base-url=<value> Maps all schema references from base url to local folder

EXAMPLES
$ asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template --param version=1.0.0 singleFile=true --output ./docs --force-write
$ asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator --param version=1.0.0 singleFile=true --output ./docs --force-write
```
All templates are installable npm packages. Therefore, the value of `template` can be anything supported by `npm install`. Here's a summary of the possibilities:
Expand Down Expand Up @@ -60,29 +60,29 @@ asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template
**The shortest possible syntax:**
```bash
asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template
asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator
```
**Generating from a URL:**
```bash
asyncapi generate fromTemplate https://bit.ly/asyncapi @asyncapi/html-template
asyncapi generate fromTemplate https://bit.ly/asyncapi @asyncapi/html-template@3.0.0 --use-new-generator
```
**Specify where to put the result:**
```bash
asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template -o ./docs
asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator -o ./docs
```
**Passing parameters to templates:**
```bash
asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template -o ./docs -p title='Hello from param'
asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator -o ./docs -p title='Hello from param'
```
In the template you can use it like this: ` {{ params.title }}`
**Disabling the hooks:**
```bash
asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template -o ./docs -d generate:before generate:after=foo,bar
asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator -o ./docs -d generate:before generate:after=foo,bar
```
The generator skips all hooks of the `generate:before` type and `foo`, `bar` hooks of the `generate:after` type.
Expand All @@ -101,7 +101,7 @@ asyncapi generate fromTemplate asyncapi.yaml https://github.com/asyncapi/html-te
**Map schema references from baseUrl to local folder:**
```bash
asyncapi generate fromTemplate test/docs/apiwithref.json @asyncapi/html-template -o ./build/ --force-write --map-base-url https://schema.example.com/crm/:./test/docs/
asyncapi generate fromTemplate test/docs/apiwithref.json @asyncapi/html-template@3.0.0 --use-new-generator -o ./build/ --force-write --map-base-url https://schema.example.com/crm/:./test/docs/
```
The parameter `--map-base-url` maps external schema references to local folders.
Expand All @@ -122,7 +122,7 @@ asyncapi/cli [COMMAND HERE]
docker run --rm -it \
-v ${PWD}/test/fixtures/asyncapi_v1.yml:/app/asyncapi.yml \
-v ${PWD}/output:/app/output \
asyncapi/cli generate fromTemplate -o /app/output /app/asyncapi.yml @asyncapi/html-template --force-write
asyncapi/cli generate fromTemplate -o /app/output /app/asyncapi.yml @asyncapi/html-template@3.0.0 --use-new-generator --force-write
```
Note: Use ``` ` ``` instead of `\` for Windows.
Expand All @@ -133,7 +133,7 @@ Note: Use ``` ` ``` instead of `\` for Windows.
Use the following npx command on your terminal:
```bash
npx -p @asyncapi/cli asyncapi generate fromTemplate ./asyncapi.yaml @asyncapi/html-template
npx -p @asyncapi/cli asyncapi generate fromTemplate ./asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator
```
## Using as a module/package
Expand All @@ -154,4 +154,4 @@ try {
}
```
See the [API documentation](api) for more examples and full API reference information.
See the [API documentation](api) for more examples and full API reference information.
2 changes: 1 addition & 1 deletion pages/blog/index.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ export default function BlogIndexPage() {
<TextLink href='/rss.xml'> RSS Feed</TextLink>, too!
</Paragraph>
</div>
<div className='mx:64 mt-12 md:flex md:justify-center lg:justify-start'>
<div className='mx:64 mt-12 md:flex md:justify-center lg:justify-center'>
<Filter
data={navItems || []}
onFilter={onFilter}
Expand Down
2 changes: 1 addition & 1 deletion pages/community/index.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -181,7 +181,7 @@ export default function CommunityIndexPage() {
/>
</div>
<div className='mt-10 flex justify-center'>
<div className='m-5 p-8 bg-gray-100 rounded-lg shadow-md w-full max-w-6xl'>
<div className='m-5 w-full max-w-6xl rounded-lg bg-gray-100 p-8 shadow-md'>
<div className='w-full'>
<Card
type={CardType.SMALL}
Expand Down
2 changes: 1 addition & 1 deletion public/_redirects
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ https://www.asyncapi.io/* https://www.asyncapi.com/:splat 301!
/asyncapi-react https://asyncapi.github.io/asyncapi-react 301!

# Slack
/slack-invite https://join.slack.com/t/asyncapi/shared_invite/zt-2vilph6cy-rFnALuzdn5XUWcp1kRfodw 302!
/slack-invite https://join.slack.com/t/asyncapi/shared_invite/zt-2yv98pzj5-sPoBxgPaoJdGF2yEFMcn3A 302!

# Central Maven repository verification
/OSSRH-63280 https://github.com/asyncapi/java-asyncapi
Expand Down
Binary file added public/img/posts/2024-conference/banner-2024.webp
Binary file not shown.
Binary file added public/img/posts/2024-conference/venues.webp
Binary file not shown.

0 comments on commit 26a2a20

Please sign in to comment.