diff --git a/README.md b/README.md index f1707c65..22d59150 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,7 @@ ACAP Bicol (ACAP 2.0) development documentation. Built with [Nextra](https://nextra.site/), a modern static site generation framework running on NextJS. +> [!IMPORTANT] > This project uses Nextra [version 2](https://nextra-v2-oe0zrpzjp-shud.vercel.app/). ### Requirements @@ -32,6 +33,8 @@ The app depends these libraries and frameworks. - [Requirements](#requirements) - [Installation](#installation) - [Usage](#usage) + - [General Usage](#general-usage) + - [Uploading and Referencing Images from /assets](#uploading-and-referencing-images-from-assets) - [Available Scripts](#available-scripts) - [Usage with Docker](#usage-with-docker) - [Use Pre-Built Development Docker Image](#use-pre-Built-development-docker-image) @@ -62,6 +65,8 @@ The app depends these libraries and frameworks. ## Usage +### General Usage + 1. Run the app for local dedvelopment with:
``` cd docs @@ -82,6 +87,35 @@ The app depends these libraries and frameworks. 3. Add or edit MDX files in the `/pages` directory, or add React components in the `/components` directory. - View the [**nextra**](https://nextra.site/docs) (docs-theme) documentation for more information on using nextra to add content. +### Uploading and Referencing Images from `/assets` + +#### To display a new image: + +1. Upload the image to the `/assets` branch, ([Issue #102](https://github.com/acaptutorials/acaptutorials.github.io/issues/102)) + - Commit the file under the appropriate directory (e.g., `/images/`, `/docs/`, etc.). + - Use **unique, versioned file names** (e.g., `feature-v2.png`) to prevent caching issues. + + > ⚠️ **NOTE:** Overwriting an existing file with a new version will **not** immediately update in browsers due to GitHub's CDN caching. + +2. Get the raw URL: + - Open the file in GitHub, click **View Raw**, and copy the URL. + - The URL will look like this:
+ `https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/` + +3. Use the raw URL in Markdown or HTML: + + **Markdown**
+ `![New Picture](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/example.png)` + + **HTML**
+ `New Picture` + +#### Best Practices + +- Use **descriptive file names** and organize assets into logical folders. +- Compress or optimize images before upload to keep repository size manageable. +- Always try to update references when renaming or versioning files. + ## Available Scripts @@ -165,6 +199,6 @@ https://hub.docker.com/r/acaptutorials/acaptutorials.github.io @acaptutorials
20240806
-20250601 +20250901 diff --git a/docs/pages/announcements.mdx b/docs/pages/announcements.mdx index b971df66..42ea1430 100644 --- a/docs/pages/announcements.mdx +++ b/docs/pages/announcements.mdx @@ -5,13 +5,13 @@ import { Cards, Image } from 'nextra/components'
- + <>![Documentation theme](/assets/docs-theme.png) - + <>![Documentation theme](/assets/docs-theme.png) - \ No newline at end of file + diff --git a/docs/pages/announcements/pagasa-10day-excel.mdx b/docs/pages/announcements/pagasa-10day-excel.mdx index d49a3f84..6a68e114 100644 --- a/docs/pages/announcements/pagasa-10day-excel.mdx +++ b/docs/pages/announcements/pagasa-10day-excel.mdx @@ -50,11 +50,7 @@ _Note: PAGASA has not announced plans to archive past Excel files._
Click to view the attached screenshot of PAGASA's announcement for more information. -![PAGASA 10-Day Excel files discontinuation announcement](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FNOZHqk2E8F8RoVvZuVVv_file?alt=media&token=88bd0b49-b7ee-45f8-843e-11bd0b9dcfe6) - - -[alternate screenshot](https://private-user-images.githubusercontent.com/30580083/481051514-2d333f63-8fc4-4d81-a8da-d0ff48698c5e.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NTY1MzczNTAsIm5iZiI6MTc1NjUzNzA1MCwicGF0aCI6Ii8zMDU4MDA4My80ODEwNTE1MTQtMmQzMzNmNjMtOGZjNC00ZDgxLWE4ZGEtZDBmZjQ4Njk4YzVlLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNTA4MzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjUwODMwVDA2NTczMFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTVkNDUzZmI0NjVhMTQxOWZhMmUxZDU4YmQ5ZTc1N2EzOGUwMWE1N2VlNWFhNGI3ODA4MTNkZDVmZDg5MjEwYzEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.cUM-tiJyihJq5r8zyiTXW_h3_Astl3obI-XvymTy684) - +![PAGASA 10-Day Excel files discontinuation announcement](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/pagasa_10day_excel_discontinued.png)
diff --git a/docs/pages/articles/deployment.mdx b/docs/pages/articles/deployment.mdx index ed6d4d56..b0313364 100644 --- a/docs/pages/articles/deployment.mdx +++ b/docs/pages/articles/deployment.mdx @@ -16,7 +16,7 @@ CI/CD using GitHub Actions deploy code updates to the **development** or **produ
-acap-git-flow +acap-git-flow ## Render Initial Blueprint Instance diff --git a/docs/pages/articles/pdf-development.mdx b/docs/pages/articles/pdf-development.mdx index f0261e38..f7976487 100644 --- a/docs/pages/articles/pdf-development.mdx +++ b/docs/pages/articles/pdf-development.mdx @@ -8,7 +8,7 @@ import { Callout, FileTree, Steps } from 'nextra/components' This is the process flow used by **ACAP 1.0** for generating bulletin PDFs. Further enhancements or updates may use new processing flows and design, which should be documented here. -![pdf-process](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2Fla11qNSxCH88jASOnkfd_thumbnail?alt=media&token=3a305baf-1b7f-4d62-a56c-7b0657567044) +![pdf-process](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/pdf_development_process.png) ## Development Requirements @@ -154,6 +154,6 @@ When creating new bulletin layouts that significantly differ from the existing o JPEG Picture References (from R5) -- Seasonal bulletin - | [link](https://www.facebook.com/daamiarfo5/photos/pb.100081488360994.-2207520000/1592305051122245/?type=3) | [mirror](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2Fchj3Xf2bfKevTDC6wiPf_thumbnail?alt=media&token=82cc0e6d-1106-4a59-a093-51eb9bd4ee9f) | [acap-pdf](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FuYvIyZMVmQJeC1YmUE4C_file?alt=media&token=eaeed002-9d3a-4124-a191-045c0c545bd8) | -- 10-day bulletin - | [link](https://www.facebook.com/photo.php?fbid=300180632708213&set=pb.100081488360994.-2207520000&type=3) | [mirror](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2F3rxIorhR1b3diTMAPfQp_thumbnail?alt=media&token=3cf9d79d-b232-4fee-aaa2-6d6620c98342) | [acap-pdf](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2Fwt062XBVBtVIQ4i2PLWz_file?alt=media&token=4a3c5d26-8576-4768-9623-596af8592ac4) | -- Special Weather Forecast bulletin - | [link](https://www.facebook.com/photo.php?fbid=329712193088390&set=pb.100081488360994.-2207520000&type=3) | [mirror](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FtHxfc7HqpNNG7mr63U3w_thumbnail?alt=media&token=11b660dc-50c2-48b4-b248-1fa9ca7d82c7) | [acap-pdf](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FYXMh4Ti7E3ytJ6HAwtHe_file?alt=media&token=5432cffc-7ff9-43c9-b156-016394ca505a) | \ No newline at end of file +- Seasonal bulletin - | [link](https://www.facebook.com/daamiarfo5/photos/pb.100081488360994.-2207520000/1592305051122245/?type=3) | [mirror](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/pdf_development_seasonal_picture_layout.png) | [acap-pdf](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/files/pdf_development_seasonal_acap.pdf) | +- 10-day bulletin - | [link](https://www.facebook.com/photo.php?fbid=300180632708213&set=pb.100081488360994.-2207520000&type=3) | [mirror](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/pdf_development_10day_picture_layout.png) | [acap-pdf](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/files/pdf_development_10day_acap.pdf) | +- Special Weather Forecast bulletin - | [link](https://www.facebook.com/photo.php?fbid=329712193088390&set=pb.100081488360994.-2207520000&type=3) | [mirror](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/pdf_development_cyclone_picture_layout.png) | [acap-pdf](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/files/pdf_development_cyclone_acap.pdf) | \ No newline at end of file diff --git a/docs/pages/installation.mdx b/docs/pages/installation.mdx index 32e32c41..ad02219c 100644 --- a/docs/pages/installation.mdx +++ b/docs/pages/installation.mdx @@ -59,6 +59,6 @@ All updates and fixes should be from the (parent) **acap-v2** repository's (de ### Questions and Inquiries - Concerns, questions, and inquiries with ACAP go through the mode of communication channel elected within ACAP (the ACAP FB Group Messenger). - > This communication channel is reserved only for the "active" and "official" ACAP members group. + > This communication channel is reserved only for the current "active" and "official" ACAP members group. - Alternatively, developers may create tickets (**GitHub Issues**) [within the (parent) **acap-v2** repository](https://github.com/amia-cis/acap-v2/issues) to describe their concerns in more detail. This page also contains code-related information about past inquiries and bug fixes that may be useful to other regions. > The main ACAP code Maintainers ("active" and "inactive") may respond to these tickets within their available time. diff --git a/docs/pages/installation/accounts.mdx b/docs/pages/installation/accounts.mdx index 4ec22cff..35357758 100644 --- a/docs/pages/installation/accounts.mdx +++ b/docs/pages/installation/accounts.mdx @@ -2,6 +2,10 @@ import { Steps, Callout } from 'nextra/components' # E. Accounts +![user accounts management](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/refs/heads/assets/images/accounts_user_mngt.png) + +## Introduction + Create ACAP admin accounts to use for testing. Developers signed in as ACAP superadmins may create other accounts later for Regional Field Officers (RFOs) by signing in to ACAP's **superadmin** dashboard. The following methods require a successfully running ACAP client + server app, carrying on from the [Integration](/installation/integration) section. diff --git a/docs/pages/post-installation/cropping-calendar.mdx b/docs/pages/post-installation/cropping-calendar.mdx index a123d34a..6295b27b 100644 --- a/docs/pages/post-installation/cropping-calendar.mdx +++ b/docs/pages/post-installation/cropping-calendar.mdx @@ -2,7 +2,7 @@ import { Cards, Card } from 'nextra/components' # Cropping Calendar -![cropping-calendar-og](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2F3TldxQy43wKXDbfQEDab_thumbnail?alt=media&token=49ab7d75-1873-44bb-a6c9-9dfb575afda7) +![cropping-calendar-og](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_cropping_calendar.png) ACAP uses crop stage data from  [cropping calendars](http://www.knowledgebank.irri.org/step-by-step-production/pre-planting/crop-calendar), following established formats as input parameters for generating crop recommendations. diff --git a/docs/pages/post-installation/cropping-calendar/calendar-v1.mdx b/docs/pages/post-installation/cropping-calendar/calendar-v1.mdx index f2a5bf8c..7a5f9956 100644 --- a/docs/pages/post-installation/cropping-calendar/calendar-v1.mdx +++ b/docs/pages/post-installation/cropping-calendar/calendar-v1.mdx @@ -2,7 +2,7 @@ import { Callout, FileTree, Steps } from 'nextra/components' # ACAP 1.0 Cropping Calendar -![cropping-calendar-v1](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FEonSaA9AfGcglBmTGMCl_thumbnail?alt=media&token=a436adfc-ce00-478f-95bc-73c1002a1a50) +![cropping-calendar-v1](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_cropping_calendar_v1.png) ## Introduction diff --git a/docs/pages/post-installation/cropping-calendar/calendar-v2.mdx b/docs/pages/post-installation/cropping-calendar/calendar-v2.mdx index a8b4397d..ffec8c1d 100644 --- a/docs/pages/post-installation/cropping-calendar/calendar-v2.mdx +++ b/docs/pages/post-installation/cropping-calendar/calendar-v2.mdx @@ -2,7 +2,7 @@ import { Callout, FileTree, Steps } from 'nextra/components' # ACAP 2.0 Cropping Calendar -![cropping-calendar-v2](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FDquztsSIzGwlamp1LCcw_thumbnail?alt=media&token=489eaafa-2f15-4cf2-852f-fffd3ddc5eaa) +![cropping-calendar-v2](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_cropping_calendar_v2.png) ## Introduction diff --git a/docs/pages/post-installation/git-flow.mdx b/docs/pages/post-installation/git-flow.mdx index a2e9f8b4..000cc581 100644 --- a/docs/pages/post-installation/git-flow.mdx +++ b/docs/pages/post-installation/git-flow.mdx @@ -8,7 +8,7 @@ CI/CD using GitHub Actions deploy code updates to the **development** or **produ
-acap-git-flow +acap-git-flow **(Optional)** Before proceeding, create a GitHub Issue describing the new feature, bug fix or task that you'll develop. This tracks and organizes the details of the incoming updates. diff --git a/docs/pages/post-installation/google-search.mdx b/docs/pages/post-installation/google-search.mdx index 618fa535..50837feb 100644 --- a/docs/pages/post-installation/google-search.mdx +++ b/docs/pages/post-installation/google-search.mdx @@ -14,7 +14,7 @@ This is an **optional** update for ACAP introduced in its 2.0 version, should de This requires the latest updates from the **acap-v2** repository at release [**v10.1.0-alpha.6**](https://github.com/amia-cis/acap-v2/releases/tag/v10.1.0-alpha.6), dev branch commit **@e2df7bf** or later. -![google-search-results](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2Fe6zX1JgvhYfyASqvzXTh_thumbnail?alt=media&token=b5561bfc-b9ce-4a41-82c3-da0618206e59) +![google-search-results](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_google_search_console.png) ## Requirements @@ -34,13 +34,12 @@ Login to a Google account. 1. Navigate to the [Google Search Console](https://search.google.com/search-console/welcome?utm_source=about-page) website registration page. 2. Select the **URL prefix** option. Enter the root domain name of the ACAP website. For example,
`https://acap-bicol.github.io`. - ![url-prefix](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FF2qEJAFShv6E2r065h0v_thumbnail?alt=media&token=b37f9dc8-2dfd-46da-8788-c104d2884c7b - ) + ![url-prefix](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/google_search_console_url_prefix.png) 3. Press the CONTINUE button. 4. Download the HTML file in the resulting **Verify ownership** window. For example, the HTML file's name is `"google9e24fb24f7c185b4.html"` - ![verification-file](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2Ful05X04I2X8s8aeE0cqR_thumbnail?alt=media&token=ce1bde38-bc2f-454e-8e4f-8812b7b61a01) + ![verification-file](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/google_search_console_verification_file.png) ### Upload HTML Verification File @@ -80,7 +79,7 @@ A `sitemap.txt` file should be available in the ACAP production GitHub Pages web 3. Submit the sitemap. 4. Wait for several days to up 1 - 2 weeks after a successful submission for the sitemap pages to become indexed and to receive feedback in the Google Search Console dashbboard - **Overview**, **Pages**, **Performace**, and others. - ![sitemap-submit-success](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2F0OyRX0CFP4qZ58GpgQKL_thumbnail?alt=media&token=6f2b6b9f-2c5b-4af1-84a1-26303b6aff41) + ![sitemap-submit-success](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/google_search_console_sitemap_success.png) @@ -105,19 +104,19 @@ While waiting for the pages to become indexed, inspect each URL defined in the ` `"https://acap-bicol.github.io/weather-services"` (without a "/") - ![seo-url-inspection](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FWBnj0xlRlZ8EwwEvsbIc_thumbnail?alt=media&token=01d26488-29ef-4865-be12-0a6d897df505) + ![seo-url-inspection](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/google_search_console_url_inspection.png)
### Request Page Indexing 1. Press the **Request Indexing** button in the page logs resulting from the [**URL Inspection**](#inspect-urls) step. - ![request-indexing](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FOsb3PBuiLSoYBP5od3NB_thumbnail?alt=media&token=2927853e-1faa-4ea6-a092-29a2bbd2ea74) + ![request-indexing](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/google_search_console_request_indexing.png)
2. Wait until **step #1** finishes successfully with an _"Indexing requested"_ message. - ![seo-request-submitted](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FDXoOB9ZcxpjgYCLivIUu_thumbnail?alt=media&token=caef5748-776e-4ac4-a20e-f842c03bb86e) + ![seo-request-submitted](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/google_search_console_request_submitted.png) ### Inspect All Sitemap URLs @@ -135,7 +134,7 @@ While waiting, observe and resolve errors that the Google Search Console may dis Navigate to the **Pages** tab and observe page indexing error logs that may appear under the **Pages** → **Why pages aren't indexed** section. Error logs may look like the screenshot: -![seo-error-logs](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2F0jeoz5Ni7sgugjP805SS_thumbnail?alt=media&token=761ebb1c-f4cd-42aa-a73d-5ec1880b06a4) +![seo-error-logs](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/google_search_console_error_logs.png) Inspect and resolve each error log. @@ -147,6 +146,6 @@ After a few days up to several weeks after a successful page indexing, view and Search for your website in Google Search and observe if it will be among the top search results. -![seo-success](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FxaOK0JvSTyZltezm9jBl_thumbnail?alt=media&token=02d33519-b355-45aa-a8a4-34a8a95bf05a) +![seo-success](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/google_search_console_seo_success.png) \ No newline at end of file diff --git a/docs/pages/post-installation/opengraph.mdx b/docs/pages/post-installation/opengraph.mdx index 8ea30a1f..64921cd0 100644 --- a/docs/pages/post-installation/opengraph.mdx +++ b/docs/pages/post-installation/opengraph.mdx @@ -12,7 +12,7 @@ ACAP only display OpenGraph images on its **production** website hosted at (GitH
-![opengraph](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2Fc7AY9auOR2eWKe50teiX_thumbnail?alt=media&token=e1f2152e-a093-47f8-82d2-1acbcf36a801) +![opengraph](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_opengraph.png) ## OpenGraph / Meta Description @@ -141,11 +141,11 @@ Upload the new OpenGraph URLs (in the `assets_dev.csv` CSV file) to the `develop ``` - ![opegraph-meta-tag](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FNq40rjtfmn244wdYV6wy_thumbnail?alt=media&token=258e5813-89b5-43cb-88d3-7195e101d31d) + ![opegraph-meta-tag](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/opengraph_meta_tag.png) 4. Share one of the public web pages in social media, for example, in a Meta (Facebook) post. Observe if the new Opengraph thumbnails are visible. - ![social-share](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FgvNvEYeKS0HAZNJyqDGb_thumbnail?alt=media&token=5f84128e-7f2c-4882-a270-f432b6b380fe) + ![social-share](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/opengraph_social_share.png) New OpenGraph thumbnails may take some time to display the latest pictures from some image hosting providers, such as Firebase Storage, depending on its server settings for `maxAge` in seconds, even if its new OpenGrapgh image URL is already visible in the `` tag from **step #3**. diff --git a/docs/pages/post-installation/pdf.mdx b/docs/pages/post-installation/pdf.mdx index 279074ee..cb66ae82 100644 --- a/docs/pages/post-installation/pdf.mdx +++ b/docs/pages/post-installation/pdf.mdx @@ -2,7 +2,7 @@ import { Callout, FileTree, Steps } from 'nextra/components' # PDF Bulletins -![pdf-header-footer](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FwAbBX9BNLmLRihukTtSi_thumbnail?alt=media&token=b6608772-524d-4e29-bf1b-f6034cdfcc27) +![pdf-header-footer](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_pdf_static.png) ACAP's bulletin PDFs use hard-coded Bicol-related text in their headers and footers to allow flexible manual layout adjustments. These static elements should be updated with text relevant to the new region. diff --git a/docs/pages/post-installation/recommendations.mdx b/docs/pages/post-installation/recommendations.mdx index 22de8a19..a3cfd54b 100644 --- a/docs/pages/post-installation/recommendations.mdx +++ b/docs/pages/post-installation/recommendations.mdx @@ -2,7 +2,7 @@ import { Cards, Card } from 'nextra/components' # Recommendations Dataset -![recommendations-og](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FflnH2AYnpJNVwwqHAcZt_thumbnail?alt=media&token=c10b51ac-a8f6-47cc-8f54-8001cf122e9d) +![recommendations-og](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_recommendations.png) This section describes methods for uploading ACAP's recommendations dataset to the database, which it uses for generating public crop recommendations or bulletin PDFs. diff --git a/docs/pages/post-installation/site-search.mdx b/docs/pages/post-installation/site-search.mdx index 902bc2a9..67218bdc 100644 --- a/docs/pages/post-installation/site-search.mdx +++ b/docs/pages/post-installation/site-search.mdx @@ -2,7 +2,7 @@ import { Callout, Steps } from 'nextra/components' # Search Bar: Site Search -![search bar keywords](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FlE08vZGvNmHuOT870iFR_file?alt=media&token=cc3d3bec-739e-4f0d-8a63-8b6b3f0f2891) +![search bar keywords](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_site_search.png) ## Introduction @@ -123,7 +123,7 @@ return ( The **About Us** page should display in the search results. - ![site search success](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FUg972YCHQreS1jQVGmif_file?alt=media&token=55f400fa-cb64-4870-9ee0-5daceb702019) + ![site search success](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/site_search_success.png) ### Commit the `data.js` file diff --git a/docs/pages/post-installation/weather-forecasts.mdx b/docs/pages/post-installation/weather-forecasts.mdx index 4fdfe8ed..e37ad77d 100644 --- a/docs/pages/post-installation/weather-forecasts.mdx +++ b/docs/pages/post-installation/weather-forecasts.mdx @@ -2,7 +2,7 @@ import { Cards, Card, Callout } from 'nextra/components' # PAGASA Weather Forecasts -![weather-services-og](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FeeeTvrL2yUh3hwB0Ekw6_thumbnail?alt=media&token=742f9561-8b7e-4b31-b0d0-e8421babcbed) +![weather-services-og](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_weather_forecasts.png) This section expands on the [Installation](/installation) guide, detailing the setup steps for updating ACAP's **Seasonal**, **10-Day**, and **Special (Severe Cyclone)** weather forecast data from the Philippine Atmospheric, Geophysical and Astronomical Services Administration (PAGASA). diff --git a/docs/pages/post-installation/weather-forecasts/seasonal-forecast.mdx b/docs/pages/post-installation/weather-forecasts/seasonal-forecast.mdx index 26d3f83c..64d50a40 100644 --- a/docs/pages/post-installation/weather-forecasts/seasonal-forecast.mdx +++ b/docs/pages/post-installation/weather-forecasts/seasonal-forecast.mdx @@ -6,7 +6,7 @@ import { FileTree, Steps, Callout } from 'nextra/components' After achieving a successful initialization from following the steps in the [Installation](/installation) section, developers will notice a blank, default Seasonal weather forecast table in the public **ACAP Services → Seasonal Forecast** page. -![seasonal-init](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FxHwCJYnRqaxO4eKjjXPV_thumbnail?alt=media&token=e25471b0-6855-4dc6-b021-7674b3b6faa9) +![seasonal-init](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_weather_forecasts_seasonal.png) Follow these steps to update it with the latest PAGASA seasonal weather forecast data. @@ -56,15 +56,15 @@ When editing the sample PAGASA Seasonal Excel file, note to supply `nda` text fo 2. Press the **SEARCH** icon button under the **Upload an Excel file** label. Look for and select the target PAGASA seasonal weather forecast Excel file from the local hard drive. - ![search-excel](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FCcnoVvo5Eh7Jp3HnpJ3B_thumbnail?alt=media&token=1e019579-cb34-4943-a90f-7fe2abaf7d28) + ![search-excel](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/weather_forecasts_seasonal_search_excel.png) 3. Fill in the input values under the **Tropical Cyclone Input** section. Refer to the seasonal Excel file's 3rd tab, which contains pictures of the expected number of tropical cyclones in JPEG/picture format to populate these values. This step is required to upload the Excel file on **step #4**. - ![tropica-cyclone-count](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FSWft12B3Olh52MASPYZ3_thumbnail?alt=media&token=6364d5ff-0721-41c3-9ca9-c8e2c48a2222) + ![tropica-cyclone-count](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/weather_forecasts_seasonal_tropical_cyclone_count.png) 4. Press the **UPLOAD** button beside the **SEARCH** icon to upload the Excel file. A successful upload should update the default seasonal weather forecast data with new data defined in the Excel file. - ![seaonal-upload-success](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2Fr3eKqHtFf39IZblyPXHT_thumbnail?alt=media&token=f51db117-6ca9-4591-ac42-987c7b218699) + ![seaonal-upload-success](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/weather_forecasts_seasonal_upload_success.png) ### Update Weather Systems Data diff --git a/docs/pages/post-installation/weather-forecasts/special-forecast.mdx b/docs/pages/post-installation/weather-forecasts/special-forecast.mdx index 4193e245..6693a61e 100644 --- a/docs/pages/post-installation/weather-forecasts/special-forecast.mdx +++ b/docs/pages/post-installation/weather-forecasts/special-forecast.mdx @@ -2,7 +2,7 @@ import { Callout, Steps } from 'nextra/components' # PAGASA Special (Severe Cyclone) Weather Forecast -![pagasa-special](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2FBNtOxjNrZXTLQf045M8e_thumbnail?alt=media&token=53bdc0b7-9ef0-4c6c-b734-cef0a44baad2) +![pagasa-special](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_weather_forecasts_cyclone.png) ## Introduction diff --git a/docs/pages/post-installation/weather-forecasts/tenday-forecast.mdx b/docs/pages/post-installation/weather-forecasts/tenday-forecast.mdx index df53d210..c9dcd901 100644 --- a/docs/pages/post-installation/weather-forecasts/tenday-forecast.mdx +++ b/docs/pages/post-installation/weather-forecasts/tenday-forecast.mdx @@ -2,7 +2,7 @@ import { Callout, Steps } from 'nextra/components' # PAGASA 10-Day Weather Forecast -![pagasa-10day](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2Flct0mjyQ7jZqOvL9R9Bt_thumbnail?alt=media&token=73f8d105-ccfa-4654-bed3-5863db824bba) +![pagasa-10day](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_weather_forecasts_10day.png) Starting **August 31, 2025**, PAGASA will no longer provide the **10-Day Excel files**. Check the [Announcements](/announcements/pagasa-10day-excel) section for more information. diff --git a/docs/pages/post-installation/webmap.mdx b/docs/pages/post-installation/webmap.mdx index f53c3bd7..d37429b5 100644 --- a/docs/pages/post-installation/webmap.mdx +++ b/docs/pages/post-installation/webmap.mdx @@ -6,7 +6,7 @@ This section covers how to update the GeoJSON map boundaries on the Home Page (t This step is labelled (Optional) because the SHAPEFILE and new AMIA Villages data for the target region may yet not be readily available during [Installation](/installation). -![homepage](https://firebasestorage.googleapis.com/v0/b/assets-cms.appspot.com/o/users%2FAwryJ0MU8zdxQFh9y0L0x2sSt8z1%2Fvk8AYU72X90C1JsoQWKv_thumbnail?alt=media&token=4ba0965e-12c1-4b22-bb40-bbe3115d734f) +![homepage](https://raw.githubusercontent.com/acaptutorials/acaptutorials.github.io/assets/images/meta/meta_webmap.png) ### Required Files