Issue with code formatting on the WP_Query docs page

[rmorse]

Issue Description

All the code examples are missing indentation.

URL of the Page with the Issue

https://developer.wordpress.org/reference/classes/wp_query/

Section of Page with the issue

Why is this a problem?

Makes it hard to read + understand

Suggested Fix

Add the tabbed indentation back in (and maybe figure out how it got lost - was it an automated process?)

[zzap]

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

[creative-andrew]

I will take care of this one if that is okay.

[creative-andrew]

Here is the list of suggested modifications:

Standard Loop:

• Fixed indentation.
• Escaped string for security.
• Added internationalization.

<?php

// The Query.
$the_query = new WP_Query( $args );

// The Loop.
if ( $the_query->have_posts() ) {
	echo '<ul>';
	while ( $the_query->have_posts() ) {
		$the_query->the_post();
		echo '<li>' . esc_html( get_the_title() ) . '</li>';
	}
	echo '</ul>';
} else {
	esc_html_e( 'Sorry, no posts matched your criteria.' );
}
// Restore original Post Data.
wp_reset_postdata();

Standard Loop Alternate:

• Fixed indentation.
• Escaped string for security.

<?php
// the query.
$the_query = new WP_Query( $args ); ?>

<?php if ( $the_query->have_posts() ) : ?>
	<!-- pagination here -->

	<!-- the loop -->
	<?php
	while ( $the_query->have_posts() ) :
		$the_query->the_post();
		?>
		<h2><?php esc_html( the_title() ); ?></h2>
	<?php endwhile; ?>
	<!-- end of the loop -->

	<!-- pagination here -->

	<?php wp_reset_postdata(); ?>

<?php else : ?>
	<p><?php esc_html_e( 'Sorry, no posts matched your criteria.' ); ?></p>
<?php endif; ?>

[github-actions]

Heads up @zzap - the "code reference" label was applied to this issue.

[zzap]

Examples are fixed and props added in https://core.trac.wordpress.org/ticket/58537

Thank you @creative-andrew for working on this ❤️

[audrasjb]

Hello @creative-andrew there is an issue in the second example:
<h2><?php esc_html( the_title() ); ?></h2>
This doesn't work :)

Should be replaced with:
<h2><?php the_title(); ?></h2>
or:
<h2><?php echo esc_html( get_the_title() ); ?></h2>
The first option is used on bundled themes (example here), so I'd go with that one. The second one adds an extra escaping, which is not strictly needed in themes guidelines.

PS: @zzap I guess you opened a Core Trac ticket to try to props people? However since there is no associated commit, I don't think it will be taken into account anywhere 😬

[zzap]

Fixed with <?php the_title( '<h2>', '</h2>' ); ?>. Thank you for spotting that @audrasjb 🙌

And yes, I wanted to give props to Andrew and was looking for a ticket without the actual commit. I guess I found out why there were none 🥲

[audrasjb]

Thanks for the update!